home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / XAMPP 1.4.14 / xampp-win32-1.4.14-installer.exe / xampp / php / pear / docs / PhpDocumentor / ChangeLog < prev    next >
Text File  |  2004-03-24  |  98KB  |  1,807 lines

  1. $Id: ChangeLog,v 1.710.2.107 2003/10/13 03:08:02 CelloG Exp $
  2. 2003-10-12  Gregory Beaver <cellog@users.sourceforge.net>
  3.     * fixed [ 771531 ] body styles not explicitly white
  4.  
  5. 2003-10-09  Gregory Beaver <cellog@users.sourceforge.net>
  6.     * added <!-- $Revision $ --> to all peardoc files written, for aid to
  7.       translators
  8.  
  9. 2003-10-08  Gregory Beaver <cellog@users.sourceforge.net>
  10.     * fixed [ 731750 ] Links to unparsed includes shown (2nd time reopened)
  11.     * fixed [ 797066 ] HighlightParser stuffs whitespace in start of string in func
  12.     * fixed [ 795095 ] top_frame.tpl doesn't output single RIC element
  13.     * fixed [ 802891 ] Inline link text does not show up
  14.  
  15. 2003-09-19  Gregory Beaver <cellog@users.sourceforge.net>
  16.     * fixed [ 792867 ] Call to undefined function
  17.     * fixed [ 795489 ] <p> getting escaped
  18.     * fixed [ 804034 ] <optional> tag not closed for peardoc2
  19.  
  20. 2003-08-31  Gregory Beaver <cellog@users.sourceforge.net>
  21.     * fixed [ 797989 ] HTML not escaped in examples (PHP < 4.3.0)
  22.  
  23. -------------------------Release 1.2.2.1 (pear)-------------------
  24. 2003-08-20  Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  25.     * Added 'abstract' to available properties in the HTMLFramesConverter
  26.     * Updated DOM/earthli and earthli templates with new graphics showing
  27.       abstract status of classes and methods. Also added icons for classes
  28.       and pages to page.tpl and class.tpl.
  29.       
  30. -------------------------Release 1.2.2------------------------
  31. 2003-08-19  Gregory Beaver <cellog@users.sourceforge.net>
  32.     * fixed [ 791030 ] old PHP version bug /t and ' becomes to "
  33.     * fixed [ 791131 ] old PHP version bug in output, if define contains "("
  34.     * fixed [ 791023 ] bug in output: <br; />
  35.     * fixed [ 791023 ] bug in output: <br; />, also implemented <function>
  36.       handling in all html templates
  37.  
  38. 2003-08-18  Gregory Beaver <cellog@users.sourceforge.net>
  39.     * fixed [ 790685 ] HighlightParser doesn't link class::method() outside methods
  40.  
  41. 2003-08-13  Gregory Beaver <cellog@users.sourceforge.net>
  42.     * added fix for 781913 for procedural pages
  43.     * really fixed [ 781913 ] usedby not when @uses at class level
  44.     * fixed [ 788271 ] HighlightParser links to methods before classes
  45.     * fixed [ 780332 ] {@link} is closing the link prematurely when a ',' is found
  46.     * fixed [ 788251 ] {@link function blah()} and {@link object blah} fail
  47.     * fixed [ 784810 ] stat failing.
  48.     * peardoc2: added use of &true; &false; and &null; in @param description
  49.     * peardoc2: added word wrapping for the benefit of translators
  50.     * more simple list fixes
  51.  
  52. 2003-08-10  Gregory Beaver <cellog@users.sourceforge.net>
  53.     * fixed [ 786180 ] simple lists fail if line starts with an inline tag
  54.  
  55. 2003-08-08  Gregory Beaver <cellog@users.sourceforge.net>
  56.     * fixed bugs in constants/globals peardoc2 generation
  57.  
  58. 2003-08-06  Gregory Beaver <cellog@users.sourceforge.net>
  59.     * fixed [ 781913 ] usedby not when @uses at class level
  60.  
  61. 2003-08-01  Gregory Beaver <cellog@users.sourceforge.net>
  62.     * fixed 2 typos in XML:DocBook/peardoc2:default
  63.  
  64. 2003-07-31  Joshua Eichorn <jeichorn@phpdoc.org>
  65.     * Spell false right
  66.  
  67. 2003-07-30  Joshua Eichorn <jeichorn@phpdoc.org>
  68.     * Don't die on empty @param or @return
  69.  
  70. 2003-07-29  Gregory Beaver <cellog@users.sourceforge.net>
  71.     * Fixed bug in PDF Converter, wasn't finding fonts (PEAR install only)
  72.     * Made PEAR do replacements on makedocs.ini so it works out of the box
  73.     * Fixed [ 779552 ] "Documention" instead of "Documentation" in generated pages
  74.     * Remove stupid use of publicweb_uri :)
  75.     * Remove possibility to change back to HTML:default
  76.     * Fixed pear install, to use new publicweb_dir and publicweb_uri
  77.     * added new pear-based docbuilder that relies on publicweb_dir config variable
  78.     * fixed missing {@id} in manual.pkg
  79.     * removed @include_once and now use file_exists/is_readable to catch
  80.       those errors.
  81.     * removed all exception handling code.  We haven't used it since June 2002.
  82.     * added Io::isIncludable() for future use
  83.  
  84. 2003-07-28  Gregory Beaver <cellog@users.sourceforge.net>
  85.     * fixed the last bug with linking in the PDF Converter, removed debug code
  86.     * fixed bug in global variable linking in PDF Converter
  87.     * fixed [ 778920 ] tutorial link warning
  88.     * fixed CHM Converter, added index generation (CHM index)
  89.  
  90. 2003-07-27  Gregory Beaver <cellog@users.sourceforge.net>
  91.     * fixed @filesource in PDF Converter
  92.     * fixed index and table of contents
  93.     * added color highlighting to PDF converter source code!
  94.     * started work on CHM converter.  It's generating a couple
  95.       of bad links that need to turn good
  96.  
  97. 2003-07-26  Gregory Beaver <cellog@users.sourceforge.net>
  98.     * fixed the PDF Converter - it's beeyootiful
  99.     * fixed serious bug - double postprocessing of highlighted
  100.       docblock source.
  101.     * fixed even more serious bug - splitting of tokens into
  102.       line numbers was totally wrong in phpDocumentorTWordParser.
  103.       Now file highlighting works perfectly (and even looks good in Mozilla!)
  104.     * moved around the manual
  105.     * fixed minor bugs in documentation
  106.     * added text color possibility to PDF Converter!  Will be modifying to
  107.       do color syntax highlighting over the next couple of days
  108.     * Modified docbuilder to add option of parsing in external window.  I like to be
  109.       able to just hit refresh.
  110.  
  111. 2003-07-25  Gregory Beaver <cellog@users.sourceforge.net>
  112.     * fixed some more problems - all done now
  113.     * fixed all the problems in XML:DocBook/peardoc2:default
  114.     * fixed problem with phpdoc.bat in PEAR install
  115.     * ran PEAR_PackageFileManager to create package.xml
  116.     * fixed problems with PEAR!
  117.     * phpDocumentor now officially conflicts with PHPDoc
  118.     * Applied fixes to ignore from PEAR_PackageFileManager
  119.  
  120. 2003-07-24  Gregory Beaver <cellog@users.sourceforge.net>
  121.     * Changed behavior again: If the first element in a file is a class,
  122.       the docblock belongs to the class.
  123.     * Updated all documentation to reflect this change in behavior
  124.     * Improved error messages for Page-level DocBlocks
  125.     * Changed behavior: if the first docblock in a file contains
  126.       a @package tag, it is a page-level DocBlock
  127.  
  128. 2003-07-22  Gregory Beaver <cellog@users.sourceforge.net>
  129.     * fixed [ 772441 ] nested arrays fail parser
  130.     * fixed DocBook/peardoc2 generation
  131.     * fixed [ 768947 ] Multiple vars not recognised
  132.     * fixed [ 767251 ] broken links when no files in default package
  133.  
  134. 2003-07-21  Joshua Eichorn <jeichorn@phpdoc.org>
  135.     * fixed [ 765455 ] phpdoc can't find php if it is in /usr/local/bin
  136.  
  137. -------------------------Release 1.2.1------------------------
  138. 2003-07-03  Gregory Beaver <cellog@users.sourceforge.net>
  139.     * config.php fixed [ 765765 ] docbuilder can't change ini dir
  140.     * default.ini changed version to 1.2.1 in title
  141.     * DocBlockTags.ini got rid of surrounding <p></p> for
  142.       single-paragraph @tag descriptions
  143.  
  144. 2003-07-03  William Hardeman <wont@users.sourceforge.net>
  145.     * fixed [ 765753 ] Extraneous trailing "-" in @uses when no description
  146.  
  147. 2003-07-02  Gregory Beaver <cellog@users.sourceforge.net>
  148.     * ready version numbering/package.xml for release 1.2.1
  149.     * fixed [ 753641 ] phpdoc -h output
  150.     * fixed [ 757077 ] smarty templates_c not in release for HTML:frames:default
  151.     * fixed up a few bugs in the @example change
  152.     * fixed bugs in CHMdefault Converter and PDFdefault Converter
  153.     * Applied Sam Blum's fixes to @example (with a few changes)
  154.     * tags.example.pkg updated docs
  155.     * fixed [ 750264 ] @ignore won't work with DocBlock Templates /**#@+
  156.     * fixed [ 731750 ] Links to unparsed includes shown (reopened)
  157.     * fixed [ 735134 ] HTML:Smarty:default Documentation can not be printed,
  158.       added print.css and modified header.tpl to use it for print
  159.  
  160. 2003-07-01  Gregory Beaver <cellog@users.sourceforge.net>
  161.     * fixed [ 764412 ] Complex class inheritance/package causes endless loop
  162.  
  163. 2003-06-29  Gregory Beaver <cellog@users.sourceforge.net>
  164.     * applied Josh's fix for 749841 to all errors.tpl
  165.  
  166. 2003-06-29  Joshua Eichorn <jeichorn@phpdoc.org>
  167.     * fixed [ 754067 ] Use the code from pear to find php
  168.  
  169. 2003-06-29  Gregory Beaver <cellog@users.sourceforge.net>
  170.     * fixed improper fix for 750392
  171.     * fixed [ 750392 ] Formatting doesn't work in Templates /**#@+
  172.     * fixed [ 752040 ] phpDocumentor 1.2.0 can't parse itself in php < 4.3.0
  173.     * fixed [ 751066 ] Return type of a constructor is not void.
  174.     * fixed [ 751101 ] output error when optional parameters are in use
  175.     * phpDocumentorTParser::handleFunctionParams() removed bizarre double
  176.       statement (not a bug, just inefficient)
  177.     * fixed [ 753278 ] @see parent::_privatefunc causes endless loop
  178.  
  179. 2003-06-28  Gregory Beaver <cellog@users.sourceforge.net>
  180.     * fixed [ 752015 ] Docbuilder problems
  181.     * fixed [ 755681 ] include error in docbuilder file_dialog.php
  182.     * fixed [ 758387 ] Use of undefined constants in DocBlockTags.inc on line 830
  183.     * fixed [ 757841 ] JavaScript-Error cause of Package-Name
  184.     * updated phpdoc.bat with fix from Sam Blum
  185.  
  186. 2003-06-27  Gregory Beaver <cellog@users.sourceforge.net>
  187.     * Replaced phpdoc.bat with Sam Blum's phpdoc.bat, fixing 749446
  188.     * Added Release-1.2.1
  189.     * fixed [ 755688 ] lost image(s)
  190.     * fixed [ 756730 ] preview image for HTML:Smarty not found
  191.  
  192. 2003-06-07  William K. Hardeman <wont@users.sourceforge.net>
  193.     * Fixed bug [ 750461 ] by modifying HTMLSmartyConverter::WriteSource(),
  194.       HTMLSmartyConverter::getSourceLink(), HTMLSmartyConverter::getSourceAnchor(),
  195.       HTMLSmartyConverter::returnSee(), and HTMLSmartyConverter::convertClass().
  196.     * Fixed bug [ 750441 ] by adding HTMLSmartyConverter::getCurrentPageLink()
  197.       method.
  198.     * Updated HandS template to include a trailing space before the
  199.       closing ) in a function/method definition.
  200.  
  201. 2003-06-04  Gregory Beaver <cellog@users.sourceforge.net>
  202.     * made parsing stop if target is empty before any parsing is done
  203.  
  204. -------------------------Release 1.2.0------------------------
  205. 2003-06-04  Gregory Beaver <cellog@users.sourceforge.net>
  206.     * phpDocumentorTParser::usesTagHandler() fixed [ 748837 ] @uses with spaces
  207.     * tags.inlinelink.pkg fixed [ 748850 ] {@link} documentation is unclear
  208.  
  209. 2003-06-04  William K. Hardeman <wont@users.sourceforge.net>
  210.     * Added two new tags arrays available for template use:
  211.       $info_tags and $api_tags in Converter.inc [ 748419 ]
  212.     * Updated HandS template to use the new tags arrays.
  213.  
  214. 2003-06-03  Gregory Beaver <cellog@users.sourceforge.net>
  215.     * phpDocumentor_IntermediateParser::_getSourceLocation()
  216.       fixed [ 748314 ] --pear on php4/pear uses . as dirname
  217.     * parserExampleTag::parserExampleTag fixed [ 747733 ]
  218.       cannot use same filename + different path in @example
  219.  
  220. 2003-06-02  Gregory Beaver <cellog@users.sourceforge.net>
  221.     * changed in-file license notices to PHP license version 3
  222.     * updated docs to reflect new template/authorship
  223.     * added new HTML:Smarty:HandS template
  224.     * fixed [ 746690 ] DocBlocks not parsed for require_once statements
  225.     * fixed [ 746692 ] makedoc.sh $TITLE bug
  226.     * fixed [ 746674 ] phpedit - vars, methods
  227.     * IntermediateParser.inc fixed minor warning if converter output type not found
  228.  
  229. 2003-05-30  Gregory Beaver <cellog@users.sourceforge.net>
  230.     * changed version to 1.2.0 readying for release
  231.     * ProceduralPages::pathMatchesParsedFile() fixed [ 731750 ]
  232.       Links to unparsed includes shown
  233.  
  234. 2003-05-29  Gregory Beaver <cellog@users.sourceforge.net>
  235.     * parserLinkInlineTag fixed [ 744028 ] {@link $el, $notfound}
  236.       returns blank text
  237.     * phpDocumentor_IntermediateParser::_setupUsesList() fixed [ 744026 ]
  238.       @uses breaks on Classes.inc
  239.     * Converter::formatUsesList() removed
  240.     * DescHTML.inc fixed warning if <code></code> is used in docblock without
  241.       any contents
  242.     * Parser.inc fixed empty <code></code> that prompted discovery of above
  243.  
  244. 2003-05-26  Gregory Beaver <cellog@users.sourceforge.net>
  245.     * HighlightParser::getInlineTags() fixed bug in handling of the end of
  246.       {@internal}} in special cases
  247.     * Fixed @uses docs minor typo
  248.     * Fixed @see docs minor typo
  249.     * Fixed @filesource docs to have accurate example
  250.  
  251. 2003-05-25  Gregory Beaver <cellog@users.sourceforge.net>
  252.     * Cleaned up docbuilder (no more javascript/include errors!)
  253.     * Switched to use of DIRECTORY_SEPARATOR (about time)
  254.     * fix small but significant bugs in XML:DocBook/peardoc2 thanks to A. Merz
  255.  
  256. 2003-05-23  Gregory Beaver <cellog@users.sourceforge.net>
  257.     * ParserDocBlock fixed [ 740871 ] crash in DocBlockTags.inc line 99
  258.     * IntermediateParser fixed [ 739740 ] Page-level docs are not generated without a @package tag
  259.     * fixed [ 741887 ] case-sensitivity bug
  260.  
  261. 2003-05-20  Gregory Beaver <cellog@users.sourceforge.net>
  262.     * fixed [ 740859 ] @uses in docblock template crashes parser
  263.  
  264. 2003-05-17  Gregory Beaver <cellog@users.sourceforge.net>
  265.     * fixed [ 729841 ] Source code only for certain file if same name used
  266.     * fixed [ 730214 ] weird filesource
  267.     * fixed [ 736832 ] Fatal error in phpDocumentorTParser.inc
  268.     * fixed warnings if a tutorial file doesn't exist
  269.     * fixed [ 732642 ] DocBook support broken/incomplete.
  270.  
  271. 2003-05-07  Gregory Beaver <cellog@users.sourceforge.net>
  272.     * docbuilder fixed 731560 docbuilder include error on linux
  273.     * phpDocumentorhowto.pkg fixed documentation of -it command-line to make
  274.       it clearer
  275.     * ParserDescParser::doSimpleList() fixed 732900 ordered list messes up
  276.     * Io.inc fixed 733100 phpdoc's help output shows 2 times option "quiet"
  277.     * parserLicenseTag::parserLicenseTag() fixed 733352 optional description
  278.       parameter in @license tag
  279.  
  280. 2003-05-02  Gregory Beaver <cellog@users.sourceforge.net>
  281.     * fixed 729360 - quietMode broken
  282.  
  283. 2003-04-29  Gregory Beaver <cellog@users.sourceforge.net>
  284.     * ParserDescCleanup.inc fixed 729653, tons of warnings
  285.     * ObjectWordParser::getWord() fixed 729638 - case insensitivity breaks
  286.       tutorial parsing
  287.  
  288. -----------------Release 1.2.0rc 2-----------------------
  289. 2003-04-28  Gregory Beaver <cellog@users.sourceforge.net>
  290.     * readied for release
  291.     * phpDocumentorTParser::handleDesc() fixed [ 727823 ] "#@+"-block quirck?
  292.     * phpDocumentorTParser::handleJavaDocDesc() fixed [ 727823 ] "#@+"-block
  293.       quirck?
  294.     * ParserDescCleanup.inc fixed [ 728167 ] HTML tags are case sensitive
  295.     * all options.ini fixed [ 728585 ] static keyword
  296.  
  297. 2003-04-25  Gregory Beaver <cellog@users.sourceforge.net>
  298.     * tags.category.pkg fixed incorrect example (oops)
  299.  
  300. 2003-04-24  Andrew Eddie <eddieajau@users.sourceforge.net>
  301.     * Change CHM class icon
  302.     * Added suport for grouping of index entries in CHM converter
  303.     * Made presentation of CHM docblock and methods more like MSDN format
  304.     * Moved 'docBuilder' index to the root directory
  305.     * Added links and introduction pages to docBuilder
  306.  
  307. 2003-04-23  Gregory Beaver <cellog@users.sourceforge.net>
  308.     * Converter::getFileSourcePath() removed ending PATH_DELIMITER, removing
  309.       annoying extra \ in output
  310.     * HTML:*,CHM:* fixed getFileSourcePath() references that need PATH_DELIMITER
  311.     * ParserDescParser fixed [ 726195 ] Formatting tags breaks lists
  312.       required LOTS of changes
  313.     * set Smarty::$use_sub_dirs to false, removed all the %% dirs from cvs
  314.     * parserLicenseTag added @package to docblock
  315.  
  316. 2003-04-22  Gregory Beaver <cellog@users.sourceforge.net>
  317.     * docbuilder: changed top.html to top.php, removes warning
  318.     * docbuilder: changed misspelling of phpDocumentor
  319.     * Updated Authors/README, manual.pkg author list
  320.     * Applied Andrew Eddie's templates CHM:default:default method.tpl, hhp.tpl
  321.       and index.hhk.tpl
  322.     * Applied Andrew Eddie's changes to CHMdefaultConverter.inc
  323.     * README updated
  324.     * parserCode::Convert() fixed [ 725742 ] code tag alignment
  325.     * fixed warnings if -po and nothing parsed is in the packages specified
  326.     * phpDocumentor_IntermediateParser::addPageIfNecessary() fixed
  327.      725788 if --packageoutput excludes files with classes
  328.  
  329. 2003-04-21  Gregory Beaver <cellog@users.sourceforge.net>
  330.     * Converter::getClassesOnPage() fixed 725161, File view displays class
  331.       symbols without names
  332.     * HTMLSmartyConverter::formatLeftIndex() fixed 725745,
  333.       HTML:Smarty:PHP not creating ric_README.html.  Needed call to writeRIC()
  334.     * XMLDocBookpeardoc2Converter fixed non-linking to constants/globals
  335.     * fixed [ 725247 ] Wrong list handling in peardoc converter
  336.     * fixed [ 725251 ] Peardoc converter again
  337.     * XMLDocBookpeardoc2Converter fixed many fatal errors (oops)
  338.     * Errors.inc changed {@inheritdoc} to {@}inheritdoc} in comment (oops)
  339.     * RoadMap updated for 2.0
  340.     * parserExampleTag was no title if @example file.php instead of
  341.       @exampel file.php title, fixed this
  342.  
  343. 2003-04-20  Gregory Beaver <cellog@users.sourceforge.net>
  344.     * fixed mistake in reworking of getLink()
  345.     * parserLinkTag fixed [ 724857 ] @link URL text broken
  346.     * Classes::processChild() fixed 724701 conflicting package names, inherited
  347.       links fails to show up - this was an OLD bug, and is a good one to fix
  348.     * Converter::getLink() split up the method into several helper methods to
  349.       aid debugging.  Found a potential problem with the use of each on the
  350.       array $packages - moved to use of $package = array_shift(array_keys($packages))
  351.       instead of list ($package,) = each($packages), fixing
  352.       724415 Non-package references not always resolved
  353.     * Smarty-2.5.0/* updated to new phpDocumentor comments from Smarty
  354.       CVS
  355.     * HighlightParser fixed 724417 Multi-level method references not linked
  356.       and I must say it is a beautiful thing
  357.     * ChangeLog removed pre-l.0 changelog, people can get old changelog from cvs
  358.       attic or from previous releases
  359.  
  360. 2003-04-19  Gregory Beaver <cellog@users.sourceforge.net>
  361.     * HTML:frames:default top_frame.tpl added target="right"
  362.     * implemented feature request 722987 Relative example files
  363.     * implemented --examplesdir command-line for 722987
  364.     * tags.example.pkg updated documentation
  365.     * phpDocumentor.howto.pkg updated docs
  366.  
  367. 2003-04-19  Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  368.     * Converter::_processTutorials() Fixed tutorial navigation bug - 
  369.       The tutorial tree builder first builds a list of tutorials that are
  370.       named as parents by other tutorials. Then, for each tutorial in that
  371.       list, it looks to see if each tutorial is named as a child by any other
  372.       tutorial. If it found that it was, it was removed *from the list of
  373.       parents*. That meant that any tutorials in the potential parents list
  374.       that named a removed tutorial as a parent would be incorrectly identified
  375.       as a root tutorial.
  376.     * Changed HTML:frames:default package selector to stop using JavaScript
  377.     * Small updates to the document trees in all templates
  378.  
  379. 2003-04-18  Gregory Beaver <cellog@users.sourceforge.net>
  380.     * fixed 723947, RIC parsing not reading the correct README
  381.     * Setup.inc.php removed reference to Template.inc
  382.     * HTMLframesConverter.cls finished documentation entirely
  383.     * removed the HTMLdefaultConverter entirely.  No one has complained about
  384.       it, and we will always convert templates to framesConverter if people ask
  385.       removed old documentation too
  386.     * default.ini updated documentation, added templatebase option
  387.     * added --templatebase command-line to implement feature 704808,
  388.       command-line switch for template directory/converter directory, also
  389.       added documentation for this
  390.     * added all templates_c directories to CVS, to remove the need to have
  391.       write access to anywhere in phpdocumentor, unless you change the source,
  392.       fixing 708928 write permissions needed on some program dirs
  393.     * HighlightParser::retrieveType() fixed 723767 space needed after
  394.       @param type $var
  395.     * migrated to Smarty 2.5.0
  396.     * phpDocumentorTParser::retrieveType() fixed 723320 @param output behaves
  397.       funny
  398.     * blank.tpl fixed {$phpdocver} to {$phpdocversion}
  399.     * HighlightParser::retrieveType() fixed 723230 warning on line 1391,
  400.       HighlightParser
  401.     * blank.tpl made this file a little sexier in all HTML-based templates
  402.     * Converter.inc removed second declaration of var $class (oops)
  403.       now phpDocumentor is PHP5-ready (for documenting php 4, of course)
  404.  
  405. 2003-04-17  Gregory Beaver <cellog@users.sourceforge.net>
  406.     * common.inc.php changed version to 1.2.0rc2dev
  407.     * Release-1.2.0rc2 added, to prepare for next release
  408.  
  409. -----------------Release 1.2.0rc 1-----------------------
  410. 2003-04-16  Gregory Beaver <cellog@users.sourceforge.net>
  411.     * Readying for release 1.2.0rc1
  412.     * phpDocumentorTParser::handleGlobal() fixed global line numbering
  413.     * implemented feature 695621, link to section of @filesource from each
  414.       element
  415.     * phpDocumentorTWordParser::addSource() fixed case of blank lines being
  416.       erased from source
  417.     * phpDocumentor_setup::readConfigFile() fixed 710700 empty
  418.       defaultpackagename = caused busy loop
  419.     * HighlightParser::retrieveType() added function to fix 715077,
  420.       HighlightParser needs @tag object classname support
  421.     * phpDocumentorTParser::retrieveType() fixed warning in special case
  422.  
  423. 2003-04-15  Gregory Beaver <cellog@users.sourceforge.net>
  424.     * Converter::getLink() fixed 718253 Using 'parent' in @example file
  425.       causes crash
  426.  
  427. 2003-04-14  Gregory Beaver <cellog@users.sourceforge.net>
  428.     * HighlightParser::$tagHandlers added @tutorial and @license as core tags
  429.     * bug698356_Output() removed @todo
  430.     * parserSourceInlineTag::arrayConvert() removed @todo
  431.     * removed double write of example source due to double processing of
  432.       all class-level docblocks in HTML*Converter (small speedup too)
  433.     * applied fixes to CHM converter
  434.     * fixed @license tag
  435.     * HTML*Converter::writeSource/writeExample added \n to output
  436.       to make it prettier, easier to read
  437.     * HTMLSmartyConverter::getSourceLink() removed weird reference to non-
  438.       existing getSourceFilename() method
  439.     * tags.link.pkg updated docs
  440.     * tags.license.pkg new docs for new tag
  441.     * parserLicenseTag added source to DocBlockTags, implementing 714025,
  442.       @license tag
  443.     * phpDocumentorTParser::retrieveType() fixed @param object $var (was parsing
  444.       as "object $var" instead of "object" and "$var" as variable name
  445.     * HighlightParser::handleClassMember() fixed 715084 HighlightParser craps
  446.       out after $var->
  447.     * parserExampleTag::parserExampleTag() fixed 715452 @example doesn't work
  448.       with anything other than .php
  449.  
  450. 2003-04-14  Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  451.     * Class access level available in templates
  452.     * Source files no longer overwrite each other
  453.     * Link to file for class available in templates
  454.     * Access level in class icons for HTML:frames:earthli
  455.     * Link from class to file docs in all templates
  456.     * HTMLFramesConverter::writeSource() - updated to used shared file source methods
  457.     * HTMLFramesConverter::getSourceLink() - updated to used shared file source methods
  458.     * HTMLFramesConverter::makeLeft() - added 'access' as a property for classes
  459.  
  460. 2003-04-14  Gregory Beaver <cellog@users.sourceforge.net>
  461.     * parserFunction::getIntricateFunctionCall() fixed 713954, @param type $var
  462.       when &$var broken
  463.     * default.ini added new templates to example generation
  464.  
  465. 2003-04-13  Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  466.     * Updated the HTML:frames:l0l33t and HTML:frames:DOM/l0l33t to the
  467.       same layouter used by the other renderers. Once again, the style
  468.       sheet is different (and there are a couple of small differences
  469.       in the templates).
  470.     * Updated all HTML:frames templates to show other packages in a frame
  471.       at the top, inside a combo-box instead of in the square frame in the
  472.       top-left.
  473.     * Fixed reference to 'Class.png' which was appearing in Opera and IE.
  474.  
  475. 2003-04-13  Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  476.     * Converter::$processed_tutorials Added this property to track
  477.       which tutorials are already in the tutorial tree
  478.     * Converter::getTutorialTree() Updated to use the list of already-
  479.       processed tutorials.
  480.     * Converter::_tutorial_path() added to retrieve the string id for
  481.       a tutorial.
  482.     * Converter::_setupTutorialTree() Fixed to use new path and processed
  483.       tutorial functions to generate a tree with one and only one copy of
  484.       each tutorial.
  485.     * Fixed HTML:frames:default and HTML:frames:phphtmllib to handle tutorial
  486.       correctly.
  487.     * Rewrote the tutorial template layouts and XMLDocBook tag matching tables for
  488.       the affected templates.
  489.     * Moved HTML:frames:earthli to HTML:frames:DOM/earthli and added 
  490.       HTML:frames:earthli as a non-DOM version of the template.
  491.     * Integrated tutorials into the main document tree for all DOM and non-DOM
  492.       templates in HTML:frames (except for l0l33t -- coming soon).
  493.     * Updated HTML:frames:default, HTML:frames:phpdoc.de, HTML:frames:phphtmllib
  494.       to use the latest version of the non-DOM templates. Layout is handled by the
  495.       same basic templates as HTML:frames:earthli (there are, after all, only so
  496.       many nice ways to lay out documentation) and specializations are done using
  497.       the stylesheet. This allows documentation to be tweaked to a good degree after
  498.       it has already been generated.
  499.     * Updated HTML:frames:DOM/default, HTML:frames:DOM/phpdoc.de to use the WebFXTree
  500.       to render the tree instead of the previous custom code.
  501.     * Added HTML:frames:DOM/phphtmllib
  502.     * Fixed some bugs in the tutorial nesting for PHPDocumentor's documentation.
  503.     * Moved earthli image source files to 'phpdoc/media/images/earthli' to avoid 
  504.       copying them into each distribution of documentation.
  505.  
  506. 2003-04-03  Gregory Beaver <cellog@users.sourceforge.net>
  507.     * Setup.inc.php fixed bug if no -o command-line specified, was using default
  508.       instead of frames converter
  509.  
  510. 2003-04-03  Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  511.     * Converter::convertMethod() added 'access' property
  512.     * Converter::convertVar() added 'access' property
  513.     * Converter::getFormattedInheritedMethods() added 'access' property
  514.     * Converter::getFormattedInheritedVars() added 'access' property
  515.     * HTMLFramesConverter::getIndexInformation() added 'access' property
  516.     * Updated entire icon set for 'earthli' theme.
  517.     * Removed unused files from 'earthli' template.
  518.     * Cleaned up the HTML:frames:default and HTML:frames:phphtmllib templates.
  519.       Both are now based on the same layout as the HTML:frames:earthli template,
  520.       but use a non-DOM tree and different stylesheets. Otherwise the code for
  521.       all three is the same.
  522.  
  523. 2003-04-02  Gregory Beaver <cellog@users.sourceforge.net>
  524.     * added bugfix to release notes
  525.  
  526. 2003-04-01  Marco von Ballmoos <mvonballmo@users.sourceforge.net>
  527.     * Updated earthli template with properly named 'Page.gif' file. (must
  528.       be uppercase so that *nix-based servers can see it.)
  529.     
  530. 2003-04-01  Gregory Beaver <cellog@users.sourceforge.net>
  531.     * XMLDocBookpeardoc2 converter: fixed several template issues
  532.     * Errors.inc added PDERROR_EMPTY_EXAMPLE_TITLE error for empty @example
  533.       title
  534.     * CHM, HTML, PDF converters: added warning if @example title is empty
  535.     * phpDocumentorTParser::handleFuncGlobal() fixed 713201 variable variables
  536.       are not parsed properly in @global
  537.     * ParserDescParser fixed 708914 <var>, <samp>, <kbd> broken
  538.  
  539. 2003-03-31    Gregory Beaver <cellog@users.sourceforge.net>
  540.     * parserDocBlock::replaceInheritDoc() fixed 711569 Fatal Error: Undefined
  541.       Method during write
  542.     * PDERROR_INHERITDOC_DONT_WORK_HERE new warning for {@inheritdoc} in
  543.       non-child class docblock
  544.     * fixed 712704 HTML:Smarty:* drops class level author information
  545.     * ParserDescParser::resetStartList() fixed notice
  546.     * ParserDescParser::setupStates() fixed 710366 <i>-Tag is ignored
  547.  
  548. 2003-03-23    Gregory Beaver <cellog@users.sourceforge.net>
  549.     * README added more notes of thanks to people who have helped make this
  550.       thingy better
  551.     * PDFdefaultConverter::writeExample() fixed stupid typo thanks to Darren
  552.       Cook
  553.     * made @returns an alias to @return
  554.     * ParserDescParser::handleSimpleList() fixed numbered lists
  555.     * Converter::sourceLine() fixed 701199 extra br in @filesource generation
  556.     * fixed bug 708559, @category tag not really working
  557.     * ParserDescParser::handleEscape() fixed rare case of <<<tag>>> not working
  558.       <<<<tag>>>> will never work, unless someone needs it. :)
  559.     * tags.abstract.pkg added new docs on @abstract
  560.     * tags.final.pkg added new docs on @final
  561.     * HighlighParser added @final as a core tag
  562.     * phpDocumentor.ini added @final as a valid tag
  563.     * ParserDescParser::handleSimpleList() fixed parsing of simple lists if
  564.       they are the last thing in a docblock
  565.     * phpDocumentorTParser::retrieveType() fixed logic bug if @param object
  566.       and no @param object objectname
  567.     * phpDocumentorTParser::retrieveType() fixed warning
  568.     * XML:DocBook/peardoc2 removed links to class $vars since they are not
  569.       documented in peardoc2
  570.  
  571. 2003-03-22    Gregory Beaver <cellog@users.sourceforge.net>
  572.     * XMLDocBookpeardoc2Converter implemented the rest of A. Merz's suggestions
  573.       regarding @throws and @access
  574.  
  575. 2003-03-20    Gregory Beaver <cellog@users.sourceforge.net>
  576.     * HTMLframesConverter fixed doc error
  577.     * phpDocumentor.howto.pkg fixed typo
  578.     * XMLDocBookpeardoc2Converter::endClass() removed write-out of class summary
  579.     * Errors.inc added missing multiple category tags
  580.     * Converter::walk_everything() fixed bug noticed by A. Merz
  581.     * XMLDocBookpeardoc2Converter fixed bugs in package.xml generation
  582.     * XMLDocBookpeardoc2Converter fixed bugs in category.xml generation
  583.     * package.tpl/class_summary.tpl for peardoc2 converter, fixed up to match
  584.       requirements of A. Merz.
  585.     * tags.example.pkg, tags.filesource.pkg added warning about PHP 4.3.0
  586.       requirement
  587.     * phpDocumentor.howto.pkg added docs about phpDocumentor.ini
  588.     * phpDocumentorTParser added more doc comments
  589.     * phpDocumentorTParser cleaned up tag handling code
  590.     * applied feature request for @tag object classname
  591.     * XMLDocBookpeardoc2Converter docblock.tpl - applied A. Merz's fix to
  592.       method parameters
  593.  
  594. 2003-03-17    Gregory Beaver <cellog@users.sourceforge.net>
  595.     * XMLDocBookConverter added safety catch so nobody can use it until it has
  596.       templates
  597.     * HighlightParser made @category a core tag
  598.     * XMLDocBookpeardoc2Converter fixed lowercasing of @category
  599.     * XMLDocBookpeardoc2Converter fixed directory names if @package contains
  600.       underscores or periods like Spreadsheet_Excel_Writer
  601.     * tags.return.pkg updated docs to reflect changes made in 1.1.0 with smart
  602.       @return value parsing (class names and value|value|classname)
  603.  
  604. 2003-03-14    Gregory Beaver <cellog@users.sourceforge.net>
  605.     * updated phpdoc.php/new_phpdoc.php to have new peardoc2 --output format
  606.     * updated makedocs.ini to have XML:DocBook/peardoc2:default
  607.  
  608. 2003-03-13    Gregory Beaver <cellog@users.sourceforge.net>
  609.     * HTMLframesConverter.cls added more docs
  610.     * HTMLframesConverter moved title to elementindex.tpl/pkgelementindex.tpl
  611.       to make I18N easier.
  612.     * Io::Io() fixed 702549, --quiet option not valid?
  613.     * improved phpDocumentor.howto.pkg description of --quiet
  614.  
  615. 2003-03-10    Gregory Beaver <cellog@users.sourceforge.net>
  616.     * added more docs to HTMLframesConverter.cls
  617.     * add warnings for use of @filesource/sourcecode = on in PHP < 4.3.0
  618.     * HTMLframesConverter.cls fixed typo
  619.     * CHMdefaultConverter::Output() fixed {@source} tag to match new syntax
  620.     * parserSourceInlineTag::arrayConvert() re-fixed 657041 {@source} doesn't
  621.       work right once and for all.
  622.     * ParserFunction::$returnsreference fixed minor error in docs
  623.     * ParserFunction::getFunctionCall() fixed minor error in docs
  624.     * HTMLSmartyConverter::convertTutorials() fixed 695622 HTML:Smarty:* has no
  625.       package-level docs
  626.     * phpDocumentorTParser::getInlineTags() fixed 698356 {@internal} not working
  627.       properly
  628.     * HTMLframesConverter.cls continued the march to completing documentation.
  629.  
  630. 2003-03-08    Gregory Beaver <cellog@users.sourceforge.net>
  631.     * phpDocumentorTParser fixed 698468 Fatal error when inline tag across two
  632.       lines
  633.  
  634. 2003-03-06    Gregory Beaver <cellog@users.sourceforge.net>
  635.     * create_package.xml.php fixed typo
  636.  
  637. 2003-03-05    Gregory Beaver <cellog@users.sourceforge.net>
  638.     * ParserDescParser::handleList() fixed 697644, text outside <li></li> crashes
  639.     * ParserDescParser::parse() fixed 697644, any unclosed html tag crashes
  640.     * Errors.inc added PDERROR_UNCLOSED_TAG and PDERROR_TEXT_OUTSIDE_LI
  641.     * phpDocumentorTParser::handleLinkInlineTag fixed 698417 {@link element
  642.       descrip} wrong
  643.     * HTMLframesConverter.cls fixed typo
  644.     * Converter::convertTutorial() fixed unterminated {@link} in docblock
  645.     * added new ParserPDF.cls documentation
  646.     * ParserPDF.inc added documentation
  647.     * HTMLframesConverter.cls added documentation
  648.     * template.vars.cls improved documentation, added some omissions
  649.  
  650. 2003-03-04    Gregory Beaver <cellog@users.sourceforge.net>
  651.     * parserCode::Convert() fixed 696883 <code> in description crashes parser,
  652.       was using ProgramExample() even in PHP 4.2.3
  653.     * fixed 697656 putting a <code> inside a <li> turns it into a literal
  654.     * PDFdefaultConverter::convertPage()/convertClass() tidied up a bit
  655.     * PDF:default:default pages.tpl - {if includeheader} should be
  656.       {if $includeheader}.  Fixes problem with multiple procedural page
  657.       headers
  658.     * phpdocpdf::ezNewPage() Fixed 697156 PHP Warning with PDF Converter
  659.     * Cezpdf::ezWhatPageNumber() patched to give error if page numbering not
  660.       started instead of just doing a PHP warning on line 311
  661.     * create_package.xml.php added dependency on PHP 4.1.0 or greater to
  662.       package.xml generation, and generic dependency generation
  663.     * Release-1.2.0rc1 update for next release
  664.     * package.xml change description field to be more attractive
  665.  
  666. 2003-03-03    Gregory Beaver <cellog@users.sourceforge.net>
  667.     * added question to FAQ about inline @example tag (we use <code></code>)
  668.  
  669. 2003-03-03    Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  670.     * Updated index rendering to use more variables instead of just 'listing'. 
  671.       Consolidated package and full index rendering into one function. 'listing'
  672.       property is retained for compatibility with existing templates.
  673.     * Updated HTML:frames:earthli template. Takes advantage of new variables in 
  674.       the HTMLframesConverter.
  675.  
  676. 2003-03-02    Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  677.     * fixed a bug in the generated page information. Classes were included
  678.       even if they were marked private and 'parseprivate' was off.
  679.  
  680. 2003-03-01    Gregory Beaver <cellog@users.sourceforge.net>
  681.     * moved what was once in classname.xml to packagename.xml
  682.     * fixed bugs in new packagename.xml generation
  683.     * XMLDocBookpeardoc2Converter::formatLeftIndex() implemented output of
  684.       packagename.xml file to complete DocBook/peardoc2 converter
  685.  
  686. 2003-02-28    Gregory Beaver <cellog@users.sourceforge.net>
  687.     * HTML:Smarty:PHP header.tpl fixed {$todolink} to {$subdir}{$todolink}
  688.     * phpDocumentor_IntermediateParser::addUses() fixed 695482, @uses not
  689.       checking to see if element is @access private
  690.     * phpDocumentor.howto.pkg, inlinetags.pkg added docs about {@*}
  691.     * Added use of {@*} to insert */ into a docblock for code examples
  692.     * Converter::formatUsesList() fixed 692552 wasn't checking for class name if
  693.       @uses class::method() or class::$var, so if more than one class contained
  694.       a method named "method()" only the first class in the list would get the
  695.       @usedby tag as a result
  696.     * Converter::formatUsesList() partial fix for 692552, @uses is screwy
  697.       If a @uses methodname() or @uses $varname was used in a class, no @usedby
  698.       would be inserted
  699.     * phpDocumentorTParser::getInlineTags() fixed 693215, {@internal}} on single
  700.       line is broken
  701.     * HighlightParser::getInlineTags() add missing space after {@internal
  702.     * added new @todo for XML:DocBook/peardoc2
  703.     * updated @todo tags
  704.     * HighlightParser::handleClassMember() fixed 687364 highlightparser
  705.       $class->member incorrect
  706.     * IntermediateParser::HandleEvent() fixed bug if --sourcecode on and a file
  707.       has no page-level docblock, no source was being generated
  708.     * IntermediateParser.inc fixed 675871, --pear breaks if non-pear repository
  709.     * class.phpdocpdf.php fixed 694742 PDF converter has no table of contents
  710.     * HTMLSmartyConverter fixed 695291 added todo list to all generated templates
  711.     * phpedit/class.tpl fixed 694594 PEAR mode: destructor image not shown by
  712.       phpedit template
  713.  
  714. 2003-02-27    Gregory Beaver <cellog@users.sourceforge.net>
  715.     * tutorials.pkg added information about {@toc}, {@id}
  716.     * ParserDescCleanup.inc fixed basics.desc reference
  717.     * phpDocumentor.howto.pkg/IntermediateParser.inc fixed using.command-line.quiet
  718.     * clarified phpDocumentor.pkg and tutorials.pkg slightly
  719.  
  720. 2003-02-25    Gregory Beaver <cellog@users.sourceforge.net>
  721.     * added earthli template to documentation, updated
  722.       XML:DocBook:peardoc2 to XML:DocBook/peardoc2:default
  723.     * applied 693213 to PDF Converter
  724.     * fixed 693213 tutorials post-processed twice
  725.     * fixed 689874 is_a is not avaliable in PHP 4.1.0
  726.     * fixed 689893 Warnings on PHP 4.1.0
  727.  
  728. 2003-02-24    Gregory Beaver <cellog@users.sourceforge.net>
  729.     * removed page_summary.tpl, page.tpl, function.tpl from peardoc2 converter
  730.     * added constants.tpl/globals.tpl to XML:DocBook/peardoc2:default
  731.     * added new constants.xml/globals.xml output for peardoc2
  732.     * removed function code from peardoc2 - no PEAR projects can have
  733.       functions
  734.     * removed procedural page code from peardoc2 converter
  735.     * fixed faulty getIncludeValue() call in CHMdefaultConverter
  736.     * remove pear_phpdoc, no longer necessary
  737.     * added tags.category.pkg (forgot last time)
  738.  
  739. 2003-02-18    Marco Von Ballmoos <mvonballmo@users.sourceforge.net>
  740.     * Added support for method and variable override resolution beyond
  741.       direct descendents and ancestors. That is, redefinitions in ALL descendent
  742.       classes are shown, and overrides are displayed if the signature matches that
  743.       of a method or variable in ANY ancestor class.
  744.     * Added a new template HTML:frames:earthli, which is driven almost purely by
  745.       a stylesheet (media/stylesheet.css).
  746.     * Fixed a bug that always returned false from CONVERTER::getvars.
  747.  
  748. 2003-02-18    Gregory Beaver <cellog@users.sourceforge.net>
  749.     * Added @category
  750.     * made new XML:DocBook/peardoc2 converter, was too PEAR-specific.
  751.     * added category support to new converter
  752.     * fixed several category-related bugs, may be a few left over
  753.     * directory hierarchy of peardoc2 converter is now 100%
  754.  
  755. 2003-02-17    Gregory Beaver <cellog@users.sourceforge.net>
  756.     * fixed toc errors in Converter.cls and Converter.methods.cls
  757.     * Defined PDFdefaultConverter::postProcess() 
  758.     * Try out fix to catch all pdf output for debugging
  759.  
  760. 2003-02-16    Gregory Beaver <cellog@users.sourceforge.net>
  761.     * template.vars.cls - fixed typo
  762.     * ParserDescParser::doSimpleList() - fixed PHP warning
  763.     * ParserDescCleanup.inc - implemented partial 687366, phpEdit-style list
  764.       support
  765.     * phpDocumentorTParser::getInlineTags() - fixed 687403 ,{@source} leaves "}" 
  766.  
  767. 2003-02-15    Gregory Beaver <cellog@users.sourceforge.net>
  768.     * template.vars.cls added in all default template vars
  769.     * fixed 687091 special characters not encoded
  770.  
  771. 2003-02-14    Gregory Beaver <cellog@users.sourceforge.net>
  772.     * removed default HTML converter from PEAR release
  773.     * changed role="script" to role="php" for phpdoc script.  the pear
  774.       installer has no recognition for role="script" (checked source code)
  775.  
  776. 2003-02-08    Gregory Beaver <cellog@users.sourceforge.net>
  777.     * moved convertTutorial() to Converter
  778.     * fixed warning in PDF converter
  779.     * added debug_backtrace() to class.pdf.php, maybe find the Cpdf bug
  780.     * implemented 683101 starting/ending line numbers for uml-related elements
  781.  
  782. 2003-02-07    Gregory Beaver <cellog@users.sourceforge.net>
  783.     * fixed bug in handling of {@internal}}
  784.     * changed {@source} syntax, updated manual
  785.     * fixed 657041 (again), {@source} not working right
  786.     * created Release-1.2.0rc1 to prepare
  787.     * fixed 680652, optional method/function parameters ignored
  788.     * removed debug code
  789.     * phpDocumentorTParser - fixed 682491, multi-line description fubared in @tag
  790.     * phpDocumentorTParser - fixed bug in getInlineTags() that screwed <pre></pre>
  791.     * fixed related bug in phpDocumentorTParser to 682490
  792.     * fixed 682490, {@internal}} not parsed right by highlightparser
  793.     * fixed 681735, need warning for {@source} in sdesc
  794.  
  795. 2003-02-06    Gregory Beaver <cellog@users.sourceforge.net>
  796.     * fixed unterminated {@internal}} in ParserElements.inc :)
  797.     * added error check for unterminated {@internal}}
  798.     * HTML-based converters - removed unused xml test for package pages
  799.     * Converter.inc - removed PHP warnings if tutorial child not found
  800.     * HighlightParser.inc - made all core tags highlighted as such
  801.     * HighlightParser.inc - removed @todo tags
  802.     * HighlightParser.inc - fixed bug if // comment is on line before
  803.       DocBlock
  804.     * HighlightParser.inc - fixed bug in handling of /**#@-*/
  805.     * fixed more 681470 problems
  806.     * fixed 681470 problems
  807.  
  808. 2003-02-05    Gregory Beaver <cellog@users.sourceforge.net>
  809.     * stupid thing isn't working, unfixing 681470
  810.     * fixed docblock template errors in parserdesccleanup
  811.     * fixed feature 681470 implementation attempt
  812.     * added beginning of implementation of feature 681470.  Still buggy, but
  813.       works very well for actual highlighting, it's the stuff around it that
  814.       is broken
  815.     * added class knowledge to {@source}
  816.     * fixed 681463, {@source} drops characters
  817.     * fixed 681459, needed strpos instead of strrpos for test, then strrpos
  818.       for getInlineTags()
  819.     * cleaned up XMLpackagePageParser.inc doc comments
  820.     * cleaned up Setup.inc.php doc comments
  821.     * cleaned up Publisher.inc doc comments
  822.     * cleaned up phpDocumentorTWordParser.inc doc comments
  823.     * cleaned up WordParser.inc doc comments
  824.     * cleaned up ParserElements.inc doc comments
  825.     * cleaned up ParserDocBlock.inc doc comments
  826.     * cleaned up ParserDescCleanup.inc doc comments
  827.     * cleaned up ParserData.inc doc comments
  828.     * cleaned up Parser.inc doc comments
  829.     * finished work on PackagePageElements doc comments
  830.     * fixed subtle bug in @tag description conversion if the description had
  831.       multiple paragraphs
  832.     * fixed mistakes in DocBlockTags.inc doc comments
  833.     * fixed 566663, @param &$arg broken
  834.  
  835. 2003-02-04    Gregory Beaver <cellog@users.sourceforge.net>
  836.     * fixed stupid bug introduced in LinkClasses
  837.     * started work on PackagePageElements doc comments
  838.     * cleaned up LinkClasses.inc doc comments
  839.     * cleaned up Io.inc doc comments
  840.     * cleaned up IntermediateParser.inc doc comments
  841.     * cleaned up InlineTags.inc doc comments
  842.     * finished documentation of HighlightParser.inc
  843.  
  844. 2003-02-03    Gregory Beaver <cellog@users.sourceforge.net>
  845.     * began documentation of HighlightParser.inc
  846.     * cleaned up EventStack.inc doc comments
  847.     * cleaned up Errors.inc doc comments
  848.     * cleaned up DocBlockTags.inc doc comments
  849.     * cleaned up DescHTML.inc doc comments
  850.     * cleaned up Converter.inc doc comments
  851.  
  852. 2003-02-02    Gregory Beaver <cellog@users.sourceforge.net>
  853.     * fixed up Converter.inc documentation comments
  854.     * made include linking MUCH smarter
  855.     * changed version to 1.2.0rc1, starting feature freeze
  856.  
  857. -----------------Release 1.2.0beta 3-----------------------
  858. 2003-02-02    Gregory Beaver <cellog@users.sourceforge.net>
  859.     * prepared release
  860.     * Added Harald Fielker's CSVdia2code converter, updated docs
  861.     * removed possibility of more than one @filesource tag
  862.     * fixed small mistake in IntermediateParser that disabled @filesource
  863.     * cleaned up some mistakes in documentation
  864.     * changed @uses syntax.  Now it accepts a description.  Does not allow
  865.       comma-delimited list, each @uses must have its own element
  866.     * changed every @uses in the source to match the new syntax
  867.  
  868. 2003-02-01    Gregory Beaver <cellog@users.sourceforge.net>
  869.     * added --sourcecode option, to generate highlighted source for every file
  870.       since source code highlighting is still unstable, this might not work
  871.     * added @package tags to everything, to get rid of phpdoc warnings
  872.     * removed cleanup_for_pear.php, not needed any longer
  873.     * removed --pear sets constructors to @access private as this makes no sense
  874.     * fixed 677826, {@link} in @see should raise error
  875.  
  876. 2003-01-31    Gregory Beaver <cellog@users.sourceforge.net>
  877.     * made --pear set constructors to @access private
  878.     * clarified --pear docs
  879.     * fixed 677105
  880.     * fixed broken links introduced by yesterday's changes
  881.     * added getId() as standard Converter function
  882.     * removed $local parameter from returnSee() in all HTML-based converters
  883.  
  884. 2003-01-30    Gregory Beaver <cellog@users.sourceforge.net>
  885.     * fixed 677938, whitespace screwy in highlightparser
  886.     * fixed 677821, define not parsed right
  887.     * fixed 677822, {@source} not showing whole line
  888.     * added docblock back into class parsing
  889.     * re-added missing else in Io.inc (thanks Marko)
  890.     * fixed bugs in inherited vars/methods introduced by last change
  891.     * moved most converter functions to Converter, cut down code size, make
  892.       updating easier
  893.  
  894. 2003-01-27    Gregory Beaver <cellog@users.sourceforge.net>
  895.     * trying fix for 675871
  896.     * fixed 670440, Io::getBase() error with patch from Marko Kaning
  897.     * moved newSmarty() to Converter
  898.     * fixed todolist.html to {$subdir}todolist.html for HTMLSmarty
  899.     * moved highlightsource/highlightdocblocksource to Converter
  900.     * changed getPPageId() to getTutorialId() so that it makes sense
  901.     * forged ahead on Converter documentation
  902.     * fixed stupid {$todolist} instead of {$todolink}
  903.     * fixed up CHMdefaultConverter, no errors with help workshop 4.4
  904.     * fixed fatal error in CHMdefault
  905.     * added forgotten link to @todo list to left frame
  906.     * added a few @todos
  907.  
  908. 2003-01-26    Gregory Beaver <cellog@users.sourceforge.net>
  909.     * fixed crash in Converter @todo list generation
  910.     * implemented 675194, -cp (Christian will be happy about this one), added
  911.       docs to phpDocumentor.howto.pkg about it
  912.     * implemented 674470, output a list of all @todos
  913.     * fixed bug in new tokenizer parser when inline tags have no params
  914.       like {@source}, {@inheritdoc}
  915.  
  916. 2003-01-25    Gregory Beaver <cellog@users.sourceforge.net>
  917.     * fixed trivial warnings in both HTML Converters
  918.     * fixed HighlightSource in HTMLSmarty Converter
  919.     * removed confusing "assuming package XXX" if no @package tag
  920.     * improved look of PDF Converter slightly
  921.     * added @filesource, @example support to PDF Converter
  922.     * fixed 661317, subpackage tutorial links broken in PDF Converter
  923.  
  924. 2003-01-24    Gregory Beaver <cellog@users.sourceforge.net>
  925.     * fixed 674059, added makedocs.ini
  926.     * fixed 674053, missing require_once support in old Parser
  927.     * started work on single @todo listing for whole project
  928.     * completed inline tag support and {@internal}} support
  929.     * fixed all the weird linebreak problems
  930.     * fixed ghastly green color of core tags in highlighted source
  931.     * fixed hang in HighlightParser
  932.  
  933. 2003-01-23    Gregory Beaver <cellog@users.sourceforge.net>
  934.     * applied test fix for determining whether we are in PEAR or not
  935.     * add find_phpdoc.php
  936.     * fixed 671620, warning in Parser.inc
  937.     * fixed 672149, @desc broken
  938.     * HIGHLY improved HighlightParser.  It is now stable
  939.     * made all source-related tags use HighlightParser
  940.  
  941. 2003-01-22    Gregory Beaver <cellog@users.sourceforge.net>
  942.     * improved documentation slightly for inline {@id} and WordParser::getWord()
  943.  
  944. 2003-01-21    Gregory Beaver <cellog@users.sourceforge.net>
  945.     * improved HighlightParser, it's almost stable now
  946.  
  947. 2003-01-20    Gregory Beaver <cellog@users.sourceforge.net>
  948.     * improved HighlightParser, it's almost stable now
  949.  
  950.  
  951. 2003-01-19    Gregory Beaver <cellog@users.sourceforge.net>
  952.     * added new HighlightParser for doing phpxref-style stuff.  Still unstable
  953.     * removed faulty "fix" for HTML*Converter::PreserveWhiteSpace()
  954.     * added "name" to list of classes on a page, in addition to sdesc, link
  955.     * updated documentation for DocBlock Desc
  956.     * applied recent HTMLframes fixes to CHMdefault
  957.     * fixed stupid HTMLframes_outputfilter usage in Smarty Converter
  958.     * fixed 670205 inherited methods have no links
  959.     * fixed 670350, package-level doc woes in HTMLframes
  960.     * fixed documentation typos pointed out by Darren Cook
  961.     * added inline example using <code> to tags.example.pkg
  962.     * added <<tag>> for escaping tags in desc, so <<code>> instead of
  963.       >code<
  964.     * added <var>, <samp>, <kbd> as per request
  965.     * fixed terrible nesting bug(s) in ParserDescCleanup
  966.     * fixed 670903
  967.  
  968. 2003-01-18    Gregory Beaver <cellog@users.sourceforge.net>
  969.     * changed version to beta3 for next cycle
  970.     * fixed 670341, <pre> not quite working for HTML converters
  971.  
  972. -----------------Release 1.2.0beta 2-----------------------
  973. 2003-01-17    Gregory Beaver <cellog@users.sourceforge.net>
  974.     * implemented 650251, @filesource
  975.     * implemented 670184, @example
  976.     * added @uses documentation
  977.     * fixed 669909, package pages don't work with PDF, by removing package page
  978.       support: all package pages must be in tutorial format to work well anyways
  979.     * added docs for @example, haven't implemented it yet though
  980.     * fixed 669615, methods disappear
  981.     * implemented {@internal}}
  982.     * fixed 669613, fatal error in XML:DocBook
  983.     * fixed 669640 javadocdesc broken
  984.     * fixed 669525, child class sdesc wrong in parent documentation
  985.     * implemented @internal, have to think about how to do {@internal}
  986.     * implemented --ignore-tags feature request
  987.     * fixed 669132, weird @package/@ignore combo causes problems
  988.     * fixed bug in <p></p> handling pointed out by Dan
  989.     * applied Christian Dickmann's fixes to Smarty Converter
  990.  
  991. 2003-01-16    Gregory Beaver <cellog@users.sourceforge.net>
  992.     * improved use of tab panes in phpedit template
  993.  
  994. 2003-01-14    Gregory Beaver <cellog@users.sourceforge.net>
  995.     * fixed wrong linking to package-level page in HTMLframesConverter
  996.     * fixed phpedit template annoying bug tabpane not selected when an anchor is
  997.       selected
  998.  
  999. 2003-01-13    Gregory Beaver <cellog@users.sourceforge.net>
  1000.     * fixed bug caused by not unsetting strings parsed in function body
  1001.     * cleaned up inherited vars/methods in phpedit template
  1002.     * fixed sorting of methods so constructor/destructor are always first in the list
  1003.     * removed element index from subpackage in phpedit template, redundant
  1004.     * fixed 666307, whitespace not ignored for @tags that need it
  1005.     * added more documentation
  1006.     * added pear_phpdoc file for pear release
  1007.  
  1008. 2003-01-11    Gregory Beaver <cellog@users.sourceforge.net>
  1009.     * added use of ifunction_call to html templates
  1010.     * added ifunction_call variable to Smarty/frames converter with intricate
  1011.       function call output for customization
  1012.  
  1013. 2003-01-10    Gregory Beaver <cellog@users.sourceforge.net>
  1014.     * made it 1.2.0beta1b
  1015.     * added feature 663439 -p, --pear commandline switch
  1016.       - destructor detection
  1017.       - $_privatevar/$_privatemethod detection, warning if no @access private
  1018.       - guesses package based on dir location relative to pear/ (package DB is
  1019.         in pear/DB, package DB subpackage tests is pear/DB/tests)
  1020.     * since pear.php.net is foobared, updating beta1a to include new features
  1021.  
  1022. 2003-01-08    Gregory Beaver <cellog@users.sourceforge.net>
  1023.     * no @package warning was a bit overzealous (reported no @package for every
  1024.       file, sometimes twice :).  Now it works
  1025.     * fixed silly bug in phpDocumentorTParser.inc, no $this-> in $this->_pv_quote_data
  1026.     * readied PEAR 1.2.0beta1a release now that Archive_Tar has been fixed
  1027.  
  1028. 2003-01-07    Gregory Beaver <cellog@users.sourceforge.net>
  1029.     * implemented feature 663436, title available for all pages in HTMLSmarty/frames
  1030.     * implemented feature 663437, error if @package missing
  1031.     * fixed bug 664058, @param not displayed in HTMLframesConverter
  1032.  
  1033. 2003-01-06    Gregory Beaver <cellog@users.sourceforge.net>
  1034.     * fixed bug in checkIgnore for parsing CHANGELOG/README/INSTALL
  1035.     * fixed bug in checkIgnore for create_package.xml.php
  1036.     * fixed bug 662630, {}-delimited vars in strings in functions screws up new parser
  1037.  
  1038. 2003-01-04    Gregory Beaver <cellog@users.sourceforge.net>
  1039.     * fixed warning in new tokenizer parser
  1040.     * fixed web interface
  1041.  
  1042. 2003-01-04    Joshua Eichorn <jeichorn@phpdoc.net>
  1043.     * Make lists in Smarty templates have smaller padding/margin
  1044.  
  1045. 2003-01-04    Gregory Beaver <cellog@users.sourceforge.net>
  1046.     * changed self-location code to dirname(realpath(__FILE__))
  1047.     * fixed stupid bug introduced by removing static from frames converter
  1048.     * removed static from frames converter
  1049.     * fixed bug 661976 - @see broken
  1050.     * fixed stylesheet for l0l33t
  1051.  
  1052. 2003-01-02    Gregory Beaver <cellog@users.sourceforge.net>
  1053.     * removed all html output for xmldocbookconverter except errors.html
  1054.     * made all DescHTML classes in DescHTML subpackage
  1055.     * made all PackagePageElements classes in Tutorials subpackage
  1056.     * moved Documentation/spec/ to Documentation/old/
  1057.     * fixed up create_package.xml.php for next release
  1058.     * added Release-1.2.0beta1
  1059.     * fixed bug in Io.inc for ignore dir/ on windows
  1060.     * fixed bug 661316, @tutorial tutorial.ext#section broken
  1061.     * modified manual as per Josh's suggestions
  1062.     * fixed bug in HTMLSmartyConverter if -o HTML:Smarty:default,HTML:Smarty:PHP
  1063.       the second run of smarty wouldn't generate $this->package_index because of
  1064.       the use of a static variable.  Switched it to a class variable.
  1065.     * removed all static vars from HTMLSmartyConverter, switched them to class
  1066.       variables.
  1067.     * fixed HTMLSmartyConverter index.html problems
  1068.  
  1069. 2003-01-01    Gregory Beaver <cellog@users.sourceforge.net>
  1070.     * Happy New Year!
  1071.     * fixed new_phpdoc.php clickable helper thingies
  1072.     * same fix for phpdoc.php
  1073.     * fixed warning in InlineTags.inc
  1074.     * fixed warnings in ParserDescCleanup.inc
  1075.     * fixed crash in PDFdefaultConverter on unknown tag
  1076.     * added media directory for PDF:default:default
  1077.     * fixed formatting of converting information display in walk_everything()
  1078.     * fixed bug 658120 - PDFdefaultConverter define.tpl typo that was wreaking havoc
  1079.     * fixed warnings in phpDocumentorTParser
  1080.     * fixed bug 658121 - sorting issues in PDFdefaultConverter
  1081.     * fixed bug if multiple templates in -o command-line
  1082.     * updated sample .ini files in user/
  1083.  
  1084. 2002-12-31    Gregory Beaver <cellog@users.sourceforge.net>
  1085.     * made {@source} absolutely kickass for phpDocumentorTParser, now highlights in all output formats!
  1086.     * fixed phpDocumentorTParser bug if there is a $variable in a "string"
  1087.     * added more documentation, fixed up existing docs
  1088.     * reformatted whitespace to spaces, docblocks to PEAR-desired format
  1089.  
  1090. 2002-12-30    Gregory Beaver <cellog@users.sourceforge.net>
  1091.     * restored refnamediv - broke titles!
  1092.     * fixed a few small bugs in new parser
  1093.     * fixed @link tag - wasn't linking!
  1094.     * fixed missing line number in defines for HTMLframesConverter
  1095.     * added missing var_default to HTML:frames:phpedit vars.tpl template
  1096.     * finished experimental tokenizer-based parser, disabled for php < 4.3.0
  1097.     * tokenizer parser is twice as fast as original parser!
  1098.     * updated docs to reflect new parser
  1099.  
  1100. 2002-12-29    Gregory Beaver <cellog@users.sourceforge.net>
  1101.     * fixed bug in {@id}, tutorial name was not being passed to packagepageparser
  1102.     * fixed problems in PDF Converter
  1103.     * removed refnamediv from output (it is considered the title of refentry)
  1104.     * fixed bug, no refsect1s past the first one were being parsed for {@toc}
  1105.     * fixed bug, titles not being parsed out properly in several cases for {@toc}
  1106.     * started work on a tokenizer-based parser, phpDocumentorTParser
  1107.  
  1108. 2002-12-27    Gregory Beaver <cellog@users.sourceforge.net>
  1109.     * added support for <i> in DocBlock desc (oops)
  1110.     * added tag contents detail in tutorials for unmatched tag error
  1111.     * added unterminated attribute error in tutorials, very handy!
  1112.     * fixed attributes in tutorials, added quote handler
  1113.     * added {@toc} tag to allow table of contents (of current file) to be easily
  1114.      inserted anywhere in a tutorial
  1115.  
  1116. 2002-12-26    Gregory Beaver <cellog@users.sourceforge.net>
  1117.     * added conversion of docbook tables into html/chm, fixed bug in attribute parsing
  1118.       of tutorials
  1119.  
  1120. 2002-12-25    Gregory Beaver <cellog@users.sourceforge.net>
  1121.     * Merry Christmas!
  1122.     * added automatic retrieval of section/subsection title for {@tutorial tutorial.ext#section.subsection}
  1123.     * added missing ; to class.tpl and page.tpl in XML:DocBook:peardoc2
  1124.     * fixed getPPageId() for HTML/CHM converters, should have just been returning id so that it
  1125.       would allow {@tutorial tutorial.ext#section.subsection} to work
  1126.     * fixed prev/next linking for tutorials again (this time actually works)
  1127.     * fixed tutorial tree generation, separated it from tutorial order generation
  1128.     * fixed tutorial linking for {@tutorial} in tutorials
  1129.     * fixed {@tutorial package/subpackage/tutorial.ext}, was passing subpackage as package
  1130.     * removed $childless_tutorials, no longer needed
  1131.     * fixed wrong start page for package in HTMLframes
  1132.     * added sorting to tutorial order, so the first tutorials are always those of the default package
  1133.     * fixed sorting of packages in the package list for HTML converters
  1134.     * upgraded new_phpdoc.php to HTML_Treemenu-1.1.2, fixed  addslashes($nodeObj->link) needed in TreeMenu.php
  1135.  
  1136. 2002-12-24    Gregory Beaver <cellog@users.sourceforge.net>
  1137.     * added output of unknown tags to templates.  Nothing is done with it, but it
  1138.       allows the option now
  1139.     * fixed subtle bug in Converter::getLink(), if parent::method() is referenced,
  1140.       sometimes the package was not set to the only possibility, and all the other
  1141.       package possibilities were not removed, allowing a potential crash
  1142.  
  1143. 2002-12-23    Gregory Beaver <cellog@users.sourceforge.net>
  1144.     * added more documentation, starting converting howto to the new manual format
  1145.     * fixed 657934, subtrees not processed in Converter
  1146.     * added parsing of comments/process instructions to tutorial parser.  For now,
  1147.       it just ignores them
  1148.     * spruced up the web interface text, it was a bit awkward, added the new
  1149.       converters and templates
  1150.     * fixed output for HTMLframesConverter::formatPkgIndex()
  1151.     * fixed CHM converter so that it looks half-decent
  1152.     * tutorials now work in every converter, every template!
  1153.  
  1154. 2002-12-22    Gregory Beaver <cellog@users.sourceforge.net>
  1155.     * fixed {@id}, works 100% now.
  1156.     * fixed a number of warnings in PDF conversion
  1157.     * added {@}inlinetag} converted to {@inlinetag} to allow easy use of
  1158.       "{@inlinetag}" as text, like "{@link}" for example
  1159.     * added documentation for @tutorial/{@tutorial}
  1160.     * fixed bug 657739, need separate categories for tutorial/doc inline tags
  1161.     * fixed bug 657726, @uses pseudo-tag @usedby not working right
  1162.     * fixed bug 657387, parent/child tutorial converted twice
  1163.     * XML:DocBook:peardoc2 is 100%!
  1164.     * tutorials work in every converter except CHM
  1165.     * CHM upgrade is pushed to next release
  1166.     * fixed case issue with README/INSTALL/CHANGELOG parsing
  1167.  
  1168. 2002-12-21    Gregory Beaver <cellog@users.sourceforge.net>
  1169.     * added new demo .ini, generates documentation in all formats on phpDocumentor
  1170.     * HTML:default is officially dead!
  1171.     * change HTML:default:* to HTML:frames:*, with big warning message to users
  1172.     * templates have stabilized, so ported DOM templates to frames converter
  1173.     * fixed a few small bugs in HTMLframes Converter
  1174.     * 100% of PDF converter is templatized
  1175.     * implemented all features that HTML converters have in PDF converter
  1176.     * added <pdffunction:funcname arg=$this->varname /> option, to use a
  1177.       $this->pdf variable in a function argument
  1178.     * fixed bug in PDFdefaultConverter::returnSee()
  1179.     * beautified PDF output a bit
  1180.     * tutorials are working in everything except XML, CHM converters
  1181.     * added 8 new templates for PDF Converter
  1182.  
  1183. 2002-12-20    Gregory Beaver <cellog@users.sourceforge.net>
  1184.     * stabilized PDFdefaultConverter much more than before
  1185.     * moved more formatting out of PDFdefaultConverter and into templates
  1186.     * added exciting new <pdffunction:funcname [return="capturevarname"] [(arg="val"|arg=$capturevarname)...] />
  1187.       to PDF default converter.  Now any Cezpdf function can be called directly
  1188.       from the templates.  see new footer.tpl/title_page.tpl for example
  1189.     * implemented feature 651716, find README/INSTALL/CHANGELOG
  1190.     * fixed bug 657041, {@source} not working right
  1191.     * fixed Parser::handleLogicBlock() docblock
  1192.     * fixed bug 653627 staticvar doesn't work
  1193.     * improved sub-tutorial list formatting for other frames templates
  1194.     * converted the rest of the tag spec to the new documentation format
  1195.     * fixed tree generation of tutorials in Converter
  1196.     * fixed HTMLframesConverter tutorial menus
  1197.     * fixed bug 654429, prev/next links not working
  1198.  
  1199. 2002-12-19    Gregory Beaver <cellog@users.sourceforge.net>
  1200.     * fixed problems with PDF Converter output!  needed "wb" in Converter::writefile()
  1201.     * fixed phpDocumentor_parse_ini_file(), needed stripcslashes() instead of stripslashes()
  1202.     * PDFdefaultConverter is functional, but output is buggy, needs a lot of work
  1203.     * added type to global variables, inadvertant omission
  1204.  
  1205. 2002-12-18    Gregory Beaver <cellog@users.sourceforge.net>
  1206.     * converted documentation for subpackage, var, version to new .pkg docbook format
  1207.  
  1208. 2002-12-17    Gregory Beaver <cellog@users.sourceforge.net>
  1209.     * moved debug, fancy_debug, alt. def of array_key_exists to common.inc.php
  1210.     * Began transfer of PDF converter over to using templates
  1211.     * PDF Converter is UNSTABLE at the moment, do not use until bugs are fixed
  1212.  
  1213. 2002-12-16    Gregory Beaver <cellog@users.sourceforge.net>
  1214.     * 100% tutorial implementation for HTML:*:*!
  1215.     * fixed subtle bug in IntermediateParser
  1216.     * fixed Prev/Next/Up links
  1217.     * 100% tutorial implementation for all HTML:frames templates!
  1218.  
  1219. 2002-12-15    Gregory Beaver <cellog@users.sourceforge.net>
  1220.     * 100% tutorial implementation for HTML:frames:phpedit!  added next/prev/up links
  1221.       few small bugs with next/prev, will fix later
  1222.     * hierarchical tutorial implementation complete for phpedit template, frames converter
  1223.     * finished core implementation of hierarchical tutorials in Converter
  1224.     * implemented beginning of hierarchical tutorials in Converter, still need
  1225.       to debug it, but it doesn't give any fatal errors
  1226.     * added tutorials to left frame of phpedit template so we can see what it
  1227.       looks like
  1228.  
  1229. 2002-12-14    Gregory Beaver <cellog@users.sourceforge.net>
  1230.     * applied Smarty link fix to frames converter, removed formatUsesList() from both
  1231.  
  1232. 2002-12-13    Gregory Beaver <cellog@users.sourceforge.net>
  1233.     * fully implemented all but the non-associated tutorials part of feature
  1234.       651275, tutorials, for HTML converters
  1235.     * fully implemented feature 651723, @tutorial/{@tutorial} fully work!
  1236.     * fixed simple bug in Converter::getTutorialLink()
  1237.     * removed annoying DIR_SEP has docblock warning in Smarty.class.php
  1238.     * added parsing of <refname> from <refnamediv> as main title of tutorials
  1239.     * added <refnamediv> to both Converters.pkg and phpDocumentor.pkg - didn't
  1240.       realize this is a required tag of refentry!
  1241.     * moved phpDocumentor_parse_ini_file to common.inc.php so web interface can use it
  1242.     * implemented feature 653608, allow user-controlled .ini directory, also allows
  1243.       full path to --useconfig command-line for cases where phpDocumentor is installed
  1244.       by root and used by users with their own config files
  1245.     * fixed accidental @tutorial tag in Converter.inc
  1246.     * revamped returnSee() to rely on {$subdir}, added output filter function for
  1247.       Smarty Converter to allow removal of annoying $local value
  1248.     * fixed Smarty tutorials
  1249.  
  1250. 2002-12-12    Gregory Beaver <cellog@users.sourceforge.net>
  1251.     * TODO: HTMLSmartyConverter tutorial writing is more complex, gotta fix it
  1252.     * fixed Converters.pkg.  Somehow, it was overwritten with phpDocumentor.pkg
  1253.     * fixed header.tpl in phpedit template to allow inherited vars to work
  1254.     * changed titles of the package-level tutorials Converters.pkg/phpDocumentor.pkg
  1255.     * updated all the other HTMLframesConverter templates to use this new functionality
  1256.     * added small comment to phpdoc.inc, was complaining about page-level docblock in parse
  1257.     * changed PHPEdit tutorial to use tabpanes instead of those annoying + signs
  1258.     * fixed Smarty cycle plugin, was adding unnecessary "\n" and screwing up output
  1259.     * fixed bug if multiple tutorials (needed to unset $curtag in XMLpackagePageParser)
  1260.     * fixed warning when parsing a {@tutorial} inline tag
  1261.     * removed accidental {@tutorial} in Errors.inc
  1262.     * fixed tutorial linking, added package page association for HTMLframesConverter
  1263.     * finished class/procedural page-level tutorial association
  1264.  
  1265. 2002-12-12    Gregory Beaver <cellog@users.sourceforge.net>
  1266.     * implemented parsing of @tutorial/{@tutorial} and automatic links to
  1267.       class tutorials from the class, and procedural file tutorials.  UNTESTED
  1268.       but if there are no @tutorial/{@tutorial} the parse works normally :)
  1269.     * changed format of $tutorials array to match what Converter was expecting.
  1270.       organized now by package/subpackage/tutorial type.
  1271.  
  1272. 2002-12-11    Gregory Beaver <cellog@users.sourceforge.net>
  1273.     * fixed significant bug 651837, @see package#element, anotherelement breaks
  1274.     * implemented core of feature 651275, tutorials.  Tutorials are parsed, and
  1275.       parserTutorials are passed to the Convert() function, but haven't
  1276.       implemented any of the convertTutorial() functions yet
  1277.     * implemented parserTutorial, parserTutorialInlineTag, but didn't set up parsing for them
  1278.     * added tutorial to the list of allowed tags and inline tags
  1279.  
  1280. 2002-12-10    Gregory Beaver <cellog@users.sourceforge.net>
  1281.     * fixed bug 650946, open new window for phpdoc.org link
  1282.     * removed masterdirectory commandline, implemented MUCH better automatic base
  1283.       determination at the advent of file parsing.
  1284.     * removes unintentional duplicate files (if -f filename.ext and -d dir include
  1285.       the same file)
  1286.  
  1287. 2002-12-09    Gregory Beaver <cellog@users.sourceforge.net>
  1288.     * added htmlentities to <code></code> in desc
  1289.     * fixed HTMLframesConverter bug in package pages, was outputting into wrong dir for linking
  1290.     * fixed bugs in left_frame.tpl of phpedit template, fixed bugs in HTMLframeConverter::makeLeft()
  1291.     * added sdesc processing to the list of cool items
  1292.     * allow unterminated <p>, now we have 100% javadoc desc compliance :)
  1293.     * added <br> to allowed tags in desc/sdesc
  1294.     * removed need for adv_htmlentities - with new system, Converter::postProcess() is called
  1295.       on all non-objectified strings, so the appropriate Converter function can be applied
  1296.     * fixed nested <ol> and <ul> parsing of descs, plus allow unterminated <li>
  1297.     * fixed silly syntax error introduced in Setup.inc.php
  1298.  
  1299. 2002-12-08    Gregory Beaver <cellog@users.sourceforge.net>
  1300.     * Added the last of the skeleton details to the peardoc2 template, time for testing
  1301.     * fixed command-line error in common.inc.php and phpdoc.bat, it should work now
  1302.     * fixed bug in @uses formatUsesList for html converters
  1303.     * fixed extra ] in method.tpl in phpedit template
  1304.     * added Julien Damon's fantastic adaptation of the PHPEdit template to frames converter
  1305.  
  1306. 2002-12-07    Gregory Beaver <cellog@users.sourceforge.net>
  1307.     * implemented 645775, line numbers
  1308.     * finished converting phphtmllib, and tweaked all templates plus HTMLframesConverter
  1309.     * fixed bug in default converter introduced by changes to page->name
  1310.     * converted phpdoc.de template over to ne frames converter
  1311.     * fixed mistakes in l0l33t, default
  1312.     * converted l0l33t template over to new frames converter
  1313.     * took the <<< out of HTMLframesConverter, added new blank.tpl to allow
  1314.       customizable startup page
  1315.  
  1316. 2002-12-06    Gregory Beaver <cellog@users.sourceforge.net>
  1317.     * fixed 641334, no support for <script language="php">
  1318.     * revised fix for 649646, it was not working for functions with any { } in them
  1319.     * fixed bug 649646, comments not parsed in functions
  1320.     * fixed broken stuff due to move
  1321.  
  1322. 2002-12-04      Joshua Eichorn <jeichorn@phpdoc.org>
  1323.         * Basic updates of includes for new direcotry schemes
  1324.         * Boat loads of cvs magic moves to clean up the root directory
  1325.           nothing shows in cvs history but i broke lots
  1326.         * Merged everything from the 1.1.0 branc back to head so if anything
  1327.           is broke i broke it
  1328.  
  1329. 2002-12-04    Gregory Beaver <cellog@users.sourceforge.net>
  1330.     * fixed crash on parsing @uses class::method()
  1331.     * partially fixed incorrect linking in HTML converters from @uses list in formatUsesList(), needed $local = true
  1332.     * fixed 648684, links incorrect to global vars and defines in HTMLSmarty
  1333.     * HTMLframesConverter and default template successfully working now
  1334.  
  1335. 2002-12-02    Gregory Beaver <cellog@users.sourceforge.net>
  1336.     * ParserData.inc    fixed bug 647494 with {@link item, item}
  1337.     * added new Smarty PHP templates from Mark van Reunswolde based on the php website look
  1338.     * added Mark van Reunswolde to the Authors list
  1339.  
  1340. 2002-12-01    Gregory Beaver <cellog@users.sourceforge.net>
  1341.     * Began work on new HTMLframesConverter to replace the default converter
  1342.       the Smarty converter will become HTMLnoframesConverter since both
  1343.       converters will be using the Smarty engine.
  1344.     * added create_package.xml.php, a tool to generate the pear package.xml file
  1345.     * added cleanup_for_pear.php, contributed by a user to make the output fit
  1346.       PEAR specs and his own preference for docblock formatting
  1347.  
  1348. 2002-11-30    Gregory Beaver <cellog@users.sourceforge.net>
  1349.     * fixed major bug introduced by flexibility :)
  1350.     * made HTMLSmartyConverter much more flexible
  1351.     * fixed 640507, links to constructors broken
  1352.     * fixed 641235, need trim in -f and -d commandline
  1353.     * fixed 646281, {@link e@a descrip} broken in package pages
  1354.     * converted Converter and phpDocumentor package-level docs to new DocBook format
  1355.     * added inline {@id} tag for xml package parser
  1356.     * completed XMPpackagePageParser!
  1357.     * added documentation for {@inheritdoc}, {@id}
  1358.     * added XMLpackagePageParser.inc and PackagePageElements.inc to repository
  1359.  
  1360. 2002-11-29    Gregory Beaver <cellog@users.sourceforge.net>
  1361.     * Classes.inc    fixed warning on 435
  1362.     * Errors.inc    fixed problem with error output in web interface (<ul> to ul)
  1363.     * phpdoc.php, new_phpdoc.php    fixed problem finding config files if running as a symlink in web interface
  1364.     * Converter.inc    fixed 645588 - no linking to functions whose name starts with "global" or "function"
  1365.  
  1366. 2002-11-27    Gregory Beaver <cellog@users.sourceforge.net>
  1367.     * added docblock's to class_summary.tpl
  1368.     * added a great deal to DocBook converter templates
  1369.     * added new ParserDescCleanup.inc, parses long descriptions into paragraphs, as well as parsing out allowed html
  1370.       tags into abstract structures that are automatically converted using an options.ini file in the template directory
  1371.       that adds the proper wrappers for the output format.  Very flexible and intuitive
  1372.  
  1373. 2002-11-24    Gregory Beaver <cellog@users.sourceforge.net>
  1374.     * added mucho to DocBook converter and peardoc2 template.  Only need to do global, include, and define templates and it's ready to go
  1375.       for PEAR
  1376.  
  1377. 2002-11-22    Gregory Beaver <cellog@users.sourceforge.net>
  1378.     * changed namespace things to fix for PEAR
  1379.  
  1380. 2002-11-20    Gregory Beaver <cellog@users.sourceforge.net>
  1381.     * implemented feature 623055, support Zend @desc
  1382.     * implemented feature 637920, easy way to extend a converter -o "HTML:Smarty/childofSmarty:template"
  1383.     * implemented feature 637660, parse type|type
  1384.  
  1385. 2002-11-19    Gregory Beaver <cellog@users.sourceforge.net>
  1386.     * implemented feature 558118, {@inheritdoc}
  1387.     * implemented feature 577714, have master directory option
  1388.     * implemented feature 634589, @uses
  1389.  
  1390. 2002-11-18    Gregory Beaver <cellog@users.sourceforge.net>
  1391.     * implemented feature 562604, docblock templates
  1392.  
  1393. 2002-11-17    Gregory Beaver <cellog@users.sourceforge.net>
  1394.     * implemented feature 566942, {@link seeelement description}
  1395.     * implemented feature 569746, make Program_Root a template thing.  It's in phpDocumentor.ini
  1396.     * significant improvement in DocBook converter and peardoc2 template
  1397.     * ParserFunction added getIntricateFunctionCall()
  1398.     * Converter added type_adjust()
  1399.  
  1400. 2002-11-16    Gregory Beaver <cellog@users.sourceforge.net>
  1401.     * nearly 100% functional DocBook converter for peardoc2
  1402.     * refined config option - now it is possible to set up phpdoc to run with no command-line options at all!
  1403.     * fixed phpdoc.php, new_phpdoc.php to work with new config option
  1404.     * added config file parsing, new command-line -c --useconfig option
  1405.     * added new Setup.inc.php, moved almost all of phpdoc.inc into there.
  1406.     * changed phpdoc_out to phpDocumentor_out
  1407.     * new_phpdoc.php,phpdoc.php changed to GET interface so people can bookmark a complicated parse, added XMLDocBook
  1408.     * IntermediateParser.inc    fixed mis-naming of bug when a Converter isn't a class
  1409.     * Added phpDocumentor.ini, removing from phpdoc.inc data that should be separate
  1410.  
  1411. 2002-11-14    Gregory Beaver <cellog@users.sourceforge.net>
  1412.     * updated documentation to reflect new stuff
  1413.     * implemented feature 564991, auto-links to php manual (also uses PHP_MANUAL# as fake package to link to the manual)
  1414.  
  1415. 2002-11-13    Gregory Beaver <cellog@users.sourceforge.net>
  1416.     * improved {@source} tag
  1417.     * Converter.inc fixed 638128, commandline win32 fails, w/relative path
  1418.     * Converter.inc fixed 638042, two declarations of checkstate()
  1419.     * PDF Converter fixed 637921
  1420.     * fixed 637928  multiple converters fails
  1421.     * fixed bug if PDEXCEPTIONS is true
  1422.  
  1423. ----------    Release 1.1.0  ------------------
  1424. 2002-11-12    Gregory Beaver <cellog@users.sourceforge.net>
  1425.     * PDF Converter enhanced <ul></ul> support
  1426.     * PDF Converter added package pages
  1427.     * Parser.inc    fixed minor bug in handling of quote data
  1428.  
  1429. 2002-11-11    Gregory Beaver <cellog@users.sourceforge.net>
  1430.     * PDF Converter added <ul></ul> support
  1431.  
  1432. 2002-11-10    Gregory Beaver <cellog@users.sourceforge.net>
  1433.     * new_phpdoc.php    added replace converter option for convenience
  1434.     * PDF Converter upgraded to pdf-php 009
  1435.     * PDFdefaultConverter   fixed bug in returnSee()
  1436.     * PDFdefaultConverter   fixed 597089, page numbering screwy
  1437.     * PDF Converter added linking from table of contents
  1438.     * PDF Converter cleaned up long description formatting
  1439.     * PDF Converter added full alphabetical index
  1440.  
  1441. 2002-11-7    Gregory Beaver <cellog@users.sourceforge.net>
  1442.     * new_phpdoc.php,phpdoc.php fixed mistake in the dropdown for Converter choice
  1443.     * Classes.inc   fixed 635264
  1444.     * removed rc2 from all 1.1.0rc2
  1445.     * Parse.inc     fixed warning on 956
  1446.     * package.xml   updated to reflect addition of phphtmllib template
  1447.     * added phphtmllib template
  1448.  
  1449. 2002-11-7    Joshua Eichorn <jeichorn@phpdoc.org>
  1450.     * small clean up of documentation for the release
  1451.         
  1452. 2002-11-7    Gregory Beaver <cellog@users.sourceforge.net>
  1453.     * fixed 591396  package difficulties
  1454.     * fixed 603668
  1455.     * Release-1.1.0 added and customized
  1456.  
  1457. 2002-11-6    Gregory Beaver <cellog@users.sourceforge.net>
  1458.     * docblock.tpl    fixed 634492, all linking broken in Smarty Converter
  1459.  
  1460. 2002-10-31    Gregory Beaver <cellog@users.sourceforge.net>
  1461.     * package.xml    added new_phpdoc.php, changed date to November (it was August - we're behind folks!)
  1462.     * index.html    added link to new_phpdoc.php, now that it works
  1463.     * Parser.inc    applied superior fix for 604254
  1464.     * Parser.inc    fixed 631853, sometimes first letter is cut off.  was using ltrim($word,' \t') instead of ltrim($word," \t")
  1465.     * Parser.inc    fixed 631842, default value of '' is ignored
  1466.     * var.tpl    renamed default to var_default
  1467.     * applied fix for weird Smarty error to case where there are no files (just classes)
  1468.  
  1469. 2001-10-31      Joshua Eichorn <jeichorn@phpdoc.org>
  1470.         * Io.inc        Fixed command line parsing, seems someone else messed it up
  1471.  
  1472. 2002-10-31    Gregory Beaver <cellog@users.sourceforge.net>
  1473.     * applied 621416 to method.tpl
  1474.     * fixed 631626    need pre-like stuff
  1475.     * fixed weird Smarty error if there are no classes
  1476.     * fixed 598086    Helvetica not added to archive
  1477.     * fixed 625686    in DOM/default, global_summary.inc.html had typo CONSTANT instead of VARIABLE
  1478.     * fixed 621416    need <br> in include.tpl
  1479.     * fixed 609989    if function has no params, @param tag ignored
  1480.     * fixed 599005    function return no longer shows up.  needed to add {$functions[func].function_return in front of
  1481.                     {$functions[func].function_call} in function.tpl for the Smarty converter
  1482.     * fixed 598910    Procedural page doc not working in Smarty
  1483.     
  1484. 2002-10-30    Gregory Beaver <cellog@users.sourceforge.net>
  1485.     * fixed 604254    multi-line space needs ltrim.  Added code in Parser.inc Parser::handleDesc() to trim unnecessary white space at line start
  1486.     * fixed bug 623050    class tree links in phpdoc.de templates are duds.  Also added two template variables to all pages
  1487.                         for all templates in HTMLdefaultConverter: cpackage and relloc.  cpackage is the current package name
  1488.                         relloc is the relative location of the current file based on package (it's either ../ or ../../ to the base)
  1489.                         this can be used to link to files in the web base
  1490.     * bug-570040    added to package tests
  1491.     * fixed it completely!  changes to getPath() needed to be in setPath()
  1492.     * changed all ->path to ->getPath(), but the added code still breaks everything.  It will remain commented until the author
  1493.       (whoever that is) explains what he was trying to do.
  1494.     * ParserData.inc    fixed annoying warnings created - fix is temporary, will do comprehensive fix later.
  1495.                         the problem was with parserPage::getPath(), which is not always used when it should be.
  1496.  
  1497. 2002-08-25    Gregory Beaver <cellog@users.sourceforge.net>
  1498.     * phpdoc.inc        fixed 4.2.0-specific bugs
  1499.     * new_phpdoc.php    fixed errors
  1500.     * Io.inc            fixed parse error
  1501.     * package.xml       added README
  1502.     * new_phpdoc.php    stabilized behavior
  1503.     * new_phpdoc.php    attempted another solution to bizarre behavior
  1504.  
  1505. 2002-08-24    Gregory Beaver <cellog@users.sourceforge.net>
  1506.     * package.xml   fixed <> and </> to be <role> and </role>
  1507.     * package.xml   added PEAR package.xml file.  It's incomplete, will require proofread and edit before release (558 lines!)
  1508.  
  1509. 2002-08-23    Gregory Beaver <cellog@users.sourceforge.net>
  1510.     * new_phpdoc.php    added mega-enhanced web interface, will be moved to phpdoc.php when approved
  1511.  
  1512. 2002-08-21    Gregory Beaver <cellog@users.sourceforge.net>
  1513.     * Parser.inc    fixed warning on 1140 if quote_data has never been set
  1514.     * fixed bug 588453, default values in function parameters screw everything up
  1515.     * fixed bug 587737, multi-line function name parsed incorrectly
  1516.     * fixed bug 587733, inherited private methods/vars should not show if parseprivate is off
  1517.     * added test case for bug 587733
  1518.     * fixed 578143, --customtags not documented (oops)
  1519.     * fixed 576507, first word of @global type firstword is cut off
  1520.     * fixed all of 575532, tags.ignore.html is formatted wrong
  1521.     * fixed 575232, phpdoc.php needs <?php instead of <?
  1522.  
  1523. 2002-08-13      Dave Viner <dviner@yahoo-inc.com>
  1524.         * fixed 575232. uses short tag <? instead of <?php
  1525.         * fixed 582360. windows path delimiter returned in ParserData.inc
  1526.         * removed php warnings when run without parameters
  1527.         * fixed display of usage message
  1528.         * error check value of parent directory in Converter.inc
  1529.        
  1530. 2002-08-09      Joshua Eichorn <jeichorn@phpdoc.org>
  1531.         * edited README, Authors small changes
  1532.  
  1533. 2002-06-25    Gregory Beaver <cellog@users.sourceforge.net>
  1534.     * fixed documentation for @ignore, edited README
  1535.     * fixed 571677, @return type descrip not showing descrip
  1536.  
  1537. 2002-06-18    Gregory Beaver <cellog@users.sourceforge.net>
  1538.     * added {@source} tag, can be {@source} for whole function or {@source line line} for excerpt.  only works for functions
  1539.     * Parser.inc    removed old dockeyword handling
  1540.     * phpdoc.inc,Parser.inc    added @parameter as alias to @param
  1541.     * phpdoc.php    added dropdown for converters to help remember their names.  Thanks to Tim Gallagher
  1542.     
  1543. ----------    Release 1.1.0rc2  ------------------
  1544. 2002-06-17      Joshua Eichorn <jeichorn@phpdoc.org>
  1545.         * lots of changes to the default smarty template
  1546.  
  1547. 2002-06-17    Gregory Beaver <cellog@users.sourceforge.net>
  1548.     * IntermediateParser.inc, Smarty_Compiler.class.php    fixed bug in @ignore
  1549.  
  1550. 2002-06-17      Roberto Berto <darkelder@users.sourceforge.net>
  1551.     * makedoc.sh    New makedoc.sh comments and version
  1552.  
  1553. 2002-06-15    Gregory Beaver <cellog@users.sourceforge.net>
  1554.     * Parser.inc    fixed small bug if -f filename.php used without path
  1555.     * Prepared for rc2, phpdoc.php, README, howto.html and Release changes
  1556.     * CHMConverter    fixed index so that it works
  1557.  
  1558. 2002-06-14    Gregory Beaver <cellog@users.sourceforge.net>
  1559.     * CHMConverter    added pre-alpha CHM converter based on htmlsmarty converter
  1560.  
  1561. 2002-06-14    Gregory Beaver <cellog@users.sourceforge.net>
  1562.     * PDFConverter    fixed it up real nice, for pre-alpha, it is somewhat useful
  1563.     * Smarty_Compiler.class.php    added @ignore tag to header output for every template
  1564.     * HTMLSmarty    fixed stylesheet/image copy
  1565.     * Converter.inc    added indenting to writefile()
  1566.     * HTMLSmarty    added cache for speedup, fixed warnings
  1567.     * HTMLSmarty    fixed left index creation
  1568.     * HTMLSmarty    fixed package index listing
  1569.     * HTMLSmarty    fixed unnecessary classtrees output
  1570.     * HTMLSmarty    fixed header.tpl, sped up left index creation in the process
  1571.     * plugins/, create_example.php    fixed @package tags
  1572.     * Parser.inc    fixed 568901 totally
  1573.     * Parser.inc    fixed handleCR, unfixed 568901 slightly
  1574.     * Converter.inc    fixed crash if parent::$el used and the class's parent is not fuond
  1575.     * phpdoc.inc    turned off exception checking
  1576.     * Io.inc    fixed @global mis-formatting
  1577.     * Parser.inc commented out debug code
  1578.     * ProceduralPages.inc    fixed faulty exception-checking code
  1579.     * moved Smarty to phpdoc/
  1580.     * howto.html,README    updated command-line for 1.1
  1581.     * makedoc.sh    fixed small error in $TEMPLATES
  1582.     
  1583. 2002-06-14      Joshua Eichorn <jeichorn@phpdoc.org>
  1584.         * howto.html  bug# 568901Doc update from Julian Ladisch (julianladisch)
  1585.         * bug-shortdesc.php     Short desc test file
  1586.         * Parser.inc            Fix for bug #568900
  1587.         * README                fix some grammar
  1588.         * Updated Roadmap
  1589.  
  1590. 2002-06-13    Roberto Berto <darkelder@users.sourceforge.net>
  1591.     * added makedoc.sh and its documentation inside INSTALL and README
  1592.     
  1593. 2002-06-13    Gregory Beaver <cellog@users.sourceforge.net>
  1594.     * finished skeleton HTMLSmartyConverter
  1595.     * started a skeleton HTMLSmartyConverter.inc
  1596.  
  1597. 2002-06-12    Gregory Beaver <cellog@users.sourceforge.net>
  1598.     * Converter.inc    added cosmetic \n to walk() after converting error log
  1599.     * fixed bug 568146, -po broken again
  1600.     * fixed bug 568131
  1601.     * fixed bugs 568137, 568135
  1602.     * Parser.inc    fixed bug 567455, incorrect short desc recognition if first line has no period and third line does
  1603.     * Converter.inc    finished docs
  1604.     * phpDocumentor.html    fixed missing "
  1605.     * HTMLdefaultConverter.inc    wasn't setting {var_default} in var_detail
  1606.     * Classes.inc    some desc comments too long for <pre></pre>
  1607.  
  1608. 2002-06-11    Gregory Beaver <cellog@users.sourceforge.net>
  1609.     * Parser.inc    fixed 567757, EOF quotes break parsing
  1610.     * Parser.inc    fixed 567681, global value needs whitespace
  1611.     * Converter.inc    added new function getGlobalValue(), getIncludeValue() which link to documented elements if found.
  1612.     * IntermediateParser.inc    fixed 567683, sorting was screwing up classes again
  1613.     * HTMLdefaultConverter.inc    classes were not listing @package, neither were pages
  1614.     * Converter.inc    fixed bugs 567652, 567654, 567578
  1615.     * finished updating inline docs
  1616.     * Parser.inc    fixed bug 567059
  1617.     * HTMLdefaultConverter.inc    fixed bug 567090
  1618.     * HTMLdefaultConverter.inc    fixed bug 567504, added {global_link} and {constant_link} to all default templates
  1619.     * HTMLdefaultConverter.inc    fixed bug 567105, errors.html totally screwed up
  1620.     
  1621. 2002-06-10    Gregory Beaver <cellog@users.sourceforge.net>
  1622.     * IntermediateParser.inc    continued documenting
  1623.  
  1624. 2002-06-09    Gregory Beaver <cellog@users.sourceforge.net>
  1625.     * HTMLdefaultConverter.inc    fixed bug 566655, blank.html not written
  1626.     * IntermediateParser.inc, Converter.inc    fixed bug 566600, var/method links awry.  Was due to sorting incorrectly
  1627.     * bug-566600.php    added test case
  1628.     * all Converters    fixed bug 566607, image files not copied.  Had to redo args to Converter, add in $templateDir
  1629.     * Parser.inc    fixed bug 566659, @param &$arg not working
  1630.     * IntermediateParser.inc    nearly finished inline documenting
  1631.     * Classes.inc    started inline documenting
  1632.     
  1633. ----------    Release 1.1.0rc1  ------------------
  1634. 2002-06-09    Gregory Beaver <cellog@users.sourceforge.net>
  1635.     * HTMLdefaultConverter.inc    added adv_htmlentitites to docblocks
  1636.  
  1637. 2002-06-08    Gregory Beaver <cellog@users.sourceforge.net>
  1638.     * PDFdefaultConverter.inc    added convertGlobal() function, wasn't there.
  1639.     * added docs for @ignore, @staticvar
  1640.     * IntermediateParser.inc    adding sorting of all elements prior to conversion, shaves another percentage or two off of execution time
  1641.     * Converter.inc    fixed bug 566210
  1642.     * had no blank.html creation, added it to HTMLdefaultConverter
  1643.     * Parser.inc    fixed warnings in functionparam handler
  1644.     * IntermediateParser.inc    fixed 566207, crash on parsing sample
  1645.     * Parser.inc    fixed 566200, incorrect function parameter parsing
  1646.     * updated tag spec for @staticvar
  1647.     * half-updated template spec for 1.1
  1648.     * Reworked Converter::Converter() command-line args
  1649.     * Converters.html    added package-level docs for Converters package
  1650.     * HTMLdefaultConverter.inc    fixed bug in ConvertPackagePage(), wasn't setting target dir correctly
  1651.     * Converter.inc    fixed bug in getLink() if explicit # package override used
  1652.     * Parser.inc    fixed rest of bug if {@link package#element} is used
  1653.     * Converterhowto.html    updated for 1.1rc1
  1654.  
  1655. 2002-06-07    Gregory Beaver <cellog@users.sourceforge.net>
  1656.     * HTMLdefaultConverter.inc    fixed package-level docs output
  1657.     * Added error/warning output into a file
  1658.     * Merged Render into HTMLdefaultConverter
  1659.     * moved adv_htmlentities into Converter.inc
  1660.     * Render.inc    removed
  1661.     * DataTypes.inc    removed
  1662.     * INSTALL    added installation instructions for those who need it
  1663.     * gave up on parsing PEAR.  PHP is too unstable at high memory usage
  1664.     * DOM/default/left.html    fixed Functions label, was Classes
  1665.     * Errors.inc    phpdoc_exception.log is now written to the target directory instead of the phpdoc base, to avoid
  1666.                     write permission issues
  1667.     * Classes.inc    fixed the last remnant of the old bug in processChild
  1668.     * Errors.inc    added new exception for case where a root has a parent in the same class
  1669.     * HTMLdefaultConverter.inc    fixed formatting problem with getRootTree()
  1670.     * HTMLdefaultConverter.inc    fixed subdirectory error in formatted inherited vars/methods
  1671.     * ParserElements.inc    made inherited vars/methods functions non-recursive
  1672.     * ProceduralPages.inc    fixed page packaging
  1673.     * Classes.inc    fixed class inheritance packaging
  1674.     * IntermediateParser.inc    fixed parserData->clean bug, was not being set to false when an element was encountered
  1675.  
  1676. 2002-06-06    Gregory Beaver <cellog@users.sourceforge.net>
  1677.     * Classes.inc    fixed very old bug in processChild, incorrect inheritance when diff file, diff package, 1 possible parent test
  1678.                     was testing if there is 1 possible *child* instead of parent
  1679.     * Converter.inc    fixed bug in getSortedClassTreeFromClass() if there was a parent in another package or not found
  1680.     * IntermediateParser.inc    fixed usage of first docblock @package
  1681.     * HTMLdefaultConverter.inc, ParserElement.inc    fixed bug in individual class tree generation
  1682.     * ProceduralPages.inc    fixed major bug in replaceElement(), was not searching the arrays for the right element
  1683.     * Converter.inc, HTMLdefaultConverter.inc    made root tree generation non-recursive
  1684.     * ParserElements.inc    added cache to parserClass::getInheritedMethods()/getInheritedVars(), instead of recursion fix, will fix later
  1685.  
  1686. 2002-06-05    Gregory Beaver <cellog@users.sourceforge.net>
  1687.     * ParserElement.inc    changed parserClass::getParentClassTree() to be non-recursive
  1688.     * added Exception tracking for hard bugs that crash php
  1689.     * Errors.inc    documented all the global error message arrays
  1690.  
  1691. 2002-06-04    Gregory Beaver <cellog@users.sourceforge.net>
  1692.     * Render.inc    fixed warning on 931
  1693.     * Converter.inc    removed recursion from getLink()
  1694.     * IntermediateParser.inc    fixed 564681, no docblocks, no packages.html output
  1695.     * fixed 564264, SDesc not doing {@link} right
  1696.     * ParserElements.inc    made inheritance of subpackage from classes within page work in parserClass::setParent()
  1697.     * HTMLdefaultConverter.inc    fixed bug 564630, need $local = false
  1698.     * bug-542586.php    added @package tests to new classes
  1699.     * HTML/default/default.inc    moved to HTML/default/HTMLdefaultConverter.inc
  1700.     * PDF/default/default.inc    moved to PDF/default/PDFdefaultConverter.inc
  1701.     * IntermediateParser.inc    changed addConverter() to reflect name changes above
  1702.     * Converter.inc    fixed bug that was putting procedural pages in package indexes by name instead of by file
  1703.     * ProceduralPages.inc    made inheritance of subpackage from classes within page work
  1704.     * Classes.inc    fixed subpackage inheritance
  1705.     * Converter.inc    fixed 563992, warning on line 861
  1706.     * Classes.inc    fixed 564135, @access private not working right
  1707.     * bug-542586.php    added testing for bug 564135
  1708.  
  1709. 2002-06-03    Gregory Beaver <cellog@users.sourceforge.net>
  1710.     * Parser.inc    fixed bug 564173, global var still looked for
  1711.     * HTML/default/default.inc    fixed minor warning on lines 804 and 805
  1712.     * HTML/default/default.inc    made auto-include linking work for different packages
  1713.     * Converter.inc    fixed 563995, li_0, needed uasort($this->*_elements) instead of usort
  1714.     * Converter.inc    fixed 564115, $par set to 0 in Converter::getLink()
  1715.     * Converter::getLink()    improved efficiency
  1716.     * Converter.inc    fixed 564108, crash in php when package#element passed to getLink() and package doesn't exist in the documentation
  1717.     * Io.inc    changed "cvs datei" to CVS file [EXPERIMENTAL].  CVS parsing kacks on branches
  1718.     * changed --converters to --output, removed --templatedir
  1719.  
  1720. 2002-06-02    Gregory Beaver <cellog@users.sourceforge.net>
  1721.     * added ParserElements.inc, containing parserElement and descendants
  1722.     * added ParserDocBlock.inc, containing all DocBlock elements
  1723.     * parserLinkInlineTag    added "mailto:*" as valid inline link
  1724.     * Parser.inc    implemented feature 559339, add abstract link for email in @author tag (using parserInlineLinkTag instead of new
  1725.                     parserEmail tag)
  1726.     * implemented feature 560892, link to classes in @var, @return and @param type if found
  1727.     * implemented parent::* processing
  1728.     * fully implemented feature 562650, parent::* linking to overridden methods
  1729.     * implemented feature 561081, better indexing
  1730.     * fixed a few warnings introduced by feature changes
  1731.     * Parser.inc    implemented feature 560375, need whitespace
  1732.     * implemented feature 553599, static variables should be documentable
  1733.     * implemented feature 558757, add Functions to left.html
  1734.     * HTMLConverter.inc    significantly reduced memory impact and increased speed as a result
  1735.     * Render.inc    removed PreOutput(), Output() now clears template memory when finished
  1736.     * Changed all references to PHPDocumentor to phpDocumentor for consistency
  1737.     * re-arranged Converters for new usage in path: Converters/outputformat (html/pdf/etc.)/name/name.inc
  1738.     * HTMLConverter.inc    fixed bug where class trees were not being written
  1739.     * HTMLConverter.inc, Render.inc    fixed bug 563729
  1740.     * Parser.inc    fixed bug 562653, crash on empty page with unterminated {@link}
  1741.  
  1742. 2002-06-01    Gregory Beaver <cellog@users.sourceforge.net>
  1743.     * added documentation of inter-package class conflicts
  1744.     * HTMLConverter.inc, Converter.inc    reorganized indexing, added informational output
  1745.     * HTMLConverter.inc    changed all get*Link() methods to have same format at Converter::get*Link
  1746.     * Converter.inc    added $text as a dummy parameter to all get*Link methods
  1747.     * implemented all of feature 560888, document name conflicts
  1748.     * create_examples.php    added inline documentation
  1749.     * Converter.inc    added several functions to generate abstract class trees and sort them
  1750.     * HTMLConverter.inc    changed getRootTree to work with the abstract class tree, fixing bug 561082
  1751.     * HTMLConverter.inc, Render.inc    fixed bug 561093, no links to other packages in package element index
  1752.     * templates    fixed <a name="#top"></a>
  1753.     * Io.inc    implemented Jason Sweat's fix for bug 562057, fixes for directory permissions
  1754.     * Io.inc    fixed bug 562252, ignore should be recursive for directories
  1755.     * Io.inc    fixed bug 560603, unknown command-line options should raise an error
  1756.     * Render.inc    added blank {function_conflicts} to methods (was missing)
  1757.     * fully implemented auto-linking to other packages, feature 560026
  1758.     * implemented feature 560891, make @param output type $varname instead of $varname type
  1759.  
  1760. 2002-05-31    Gregory Beaver <cellog@users.sourceforge.net>
  1761.     * ParserData.inc    implemented feature request 562250, no die on illegal package name, set to default and continue parsing
  1762.     * Parser.inc    fixed bug 561392, warning on line 874
  1763.     * ProceduralPages.inc    fixed bug 561394, fatal error on line 329
  1764.     * Parser.inc    fixed bug 562997, class being parsed out of quote in php code
  1765.     * Parser.inc    fixed bug 563005, global handler broken
  1766.     * fixed bug 561396, many pages not in left.html
  1767.     * Converter.inc    moved sorting of indexes from HTMLConverter.inc
  1768.     * tests/    removed name conflicts with function test() and function test2()
  1769.     * fixed parse private, default package name, and package output.  All three were intertwined, and all three now work the way they should
  1770.  
  1771. 2002-05-27    Gregory Beaver <cellog@users.sourceforge.net>
  1772.     * IntermediateParser.inc    moved all element indexing to Converter where it belongs.
  1773.     * Classes.inc, ProceduralPages.inc    moved all indexing to fullpath for conflicts, added full conflict handling
  1774.     * phpdoc.inc    added @ignore tag for handling conflicts
  1775.     * Errors.inc    added several errors relating to name conflicts
  1776.     * IntermediateParser.inc    moved all handling of procedural elements to ProceduralPages.inc, much cleaner code
  1777.     * ParserData.inc    adjusted parserClass functions to work with fullpath instead of files
  1778.     * ProceduralPages.inc    Works now (mostly)
  1779.     * If a procedural page has 1 package used by classes in it, it will inherit the package now
  1780.     * DataTypes.inc    fixed bug 562073, adv_htmlentities should use html_specialchars
  1781.     * DataTypes.inc    fixed bug in DataDocBlock::setGlobal() causing blank @global tag in output for every function
  1782.     * phpdoc.inc    documented global variables
  1783.  
  1784. 2002-05-26    Gregory Beaver <cellog@users.sourceforge.net>
  1785.     * added @global for functions
  1786.     * ParserData.inc    added getFullPath() function to parserPage, for name conflict resolution
  1787.     * ProceduralPage.inc    added intermediary structure similar to Classes.inc
  1788.  
  1789. 2002-05-25    Gregory Beaver <cellog@users.sourceforge.net>
  1790.     * Io.inc,phpdoc.inc,Parser.inc    added feature 556757, JavaDoc-compliant description
  1791.     * phpdoc.php    updated for new features
  1792.     * Io.inc,phpdoc.inc    added feature 550308, custom tags
  1793.     * Io.inc    fixed bug 560604, phpdoc -h cuts off name in --defaultpackagename
  1794.     * updated all docs for global variable, changed version to 1.1, since we started version 1.1 changes
  1795.     * tags.param.html    fixed error in documentation, had reference to @return which was incorrect
  1796.     * finished addition of @global for variable definition, added to all templates
  1797.     * added parsing of global variables, only to l0l33t for now.  extensive changes to most files
  1798.     * l0l33t/page.html    fixed bug 560532, was missing inclusion of page-level docblock
  1799.     * ParserData.inc    fixed crash
  1800.     * Classes.inc    fixed bug 560598 by adding error to Errors.inc
  1801.     * Parser.inc    fixed bug 560595, fail on invalid docblock with @
  1802.     * Parser.inc    fixed bug 560578, @author test @ not working
  1803.     * IntermediateParser.inc, ParserData.inc, Errors.inc    added feature 560586
  1804.  
  1805. ----------    Release 1.0.0  ------------------
  1806. vim: set expandtab:
  1807.